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ABSTRACT 


This  thesis  deals  with  the  design  of  a  Navy  battle  group  logistics  simulation  system  to 
support  battle  group  logistics  coordinators.  BGLCSS  2.0,  the  Battle  Group  Logistics 
Coordinator  Support  System,  was  designed  and  developed  using  a  structured  programming 
paradigm.  A  subset  of  BGLCSS  2.0  was  then  designed  using  an  object-oriented 
programming  paradigm.  We  present  the  components  of  each  of  these  designs  in  C  and 
C4-+, 

Our  approach  was  to  compare  and  critique  these  two  designs  with  respect  to  the  extent 
to  which  their  respective  programming  paradigms  meet  the  software  goals  of  software 
reusability  and  ease  of  program  extension  and  maintenance.  We  designed  the  graphical  user 
interface  using  TAE  Plus  which  generated  code  in  both  C  and  C++.  This  mechanism 
provides  an  easy  way  to  transport  the  interface  from  a  C  implementation  to  a  C+-i- 
implementation  in  the  future. 

The  design  of  this  real  world  Navy  tactical  decision  aid  clearly  demonstrate  the 
problems  associated  with  using  structured  programming  paradigm  and  the  benefits  of  using 
an  object-oriented  programming  paradigm,  especially  for  large  systems. 
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I.  INTRODUCTION 


A.  BACKGROUND  OF  BGLCSS 

The  Battle  Group  •  jgistics  Coordinator  Support  System  (BGLCSS)  is  a  logistics 
simulation  modeling  tool  to  be  used  by  battle  group  logistics  coordinators  to  track,  plan, 
and  predict  F-76  ship  fuel,  F-44  aircraft  fuel,  and  ordnance  states  for  ships  in  a  battle  group. 

king  these  states  involves  applying  various  usage  rates  for  each  commodity  and  ship 
type  based  on  the  passage  of  time  and  the  planning  and  scheduling  of  battle  group  events 
(SCHRADY  90] .  Battle  group  events  that  can  be  planned  include  underway  replenishment 
and  consol.  Events  that  can  be  scheduled  include  ship  stationing  events,  raids,  strikes,  anti¬ 
submarine  warfare  (ASW)  prosecutions,  changes  in  ship  or  battle  group  course  and  speed, 
fuel  and  ordnance  tran.sfers  outside  the  battle  group,  and  changes  in  ASW  or  anti-aircraft 
warfare  (AAW)  threat  level. 

BGLCSS  1.0,  written  in  Turbo  Pascal  6.0  for  a  DOS  environment,  is  the  predeces.sor 
to  BGLCSS  2.0  and  was  originally  developed  by  the  Operations  Research  Department  at 
the  Naval  Postgraduate  School.  After  the  program  was  tested  during  Commander  Second 
Fleet,  Fleet  Exercise  (C2F  FLEETX  3-90)  in  June,  1990,  and  during  C2F  FLEETX  1/91-2/ 
91  in  November,  1990,  it  was  decided  to  move  the  program  to  the  Navy  Tactical  Command 
System  Afloat  (NTCS-A)  Unified  Build  2.0.  This  system  consists  of  a  set  of  applications 
including  the  Joint  Operational  Tactical  System  (JOTS  11)  (INRl  91b]. 

JOTS  II  is  an  automated  Command,  Control,  and  Communications  Display  and 
Decision  System  designed  to  meet  the  tactical  situation  as.sessment  needs  of  battle  group/ 
force  commanders,  surface  warfare  commanders,  ship  commanding  officers,  and  shore 
command  centers  fINRI  92c].  JOTS  II  has  digital  interfaces  with  a  variety  of  military 
communications  systems  and  other  shipboard  computer  systems.  It  processes  tactical 
information  received  from  other  systems  and  automatically  correlates  this  data  with  its 
existing  tactical  contact  or  Track  Data  Base  Manager  (TDBM).  This  tactical  databa.se  is 
then  used  to  generate  computer  graphics  images  at  color  Sun  workstations  [INRI  92a]. 
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The  workstations  operate  using  a  modified  version  of  the  standard  commercial  UNIX 
operating  system  SunOS  4.1.1.  Applications  are  written  in  either  C  or  Ada  and  use  the  X 
Window  Manager  and  Government  Off  The  Shelf  Software  (GOTS)  programming  tools. 
Among  these  GOTS  tools,  the  Wizard  Tool  Kit,  is  a  Motif-based  C  function  library  used 
for  building  graphical  user  interfaces  {INRI  92di. 

BGLCSS  2.0,  a  tactical  decision  aid  within  the  NTCS-A  Unified  Build  Sy.stem 
architecture,  is  shown  in  Figure  1.  It  is  written  in  C  using  a  structured  programming 
paradigm  and,  instead  of  using  the  Wizard  Tool  Kit  for  building  the  graphical  user 
interface,  uses  Transportable  Applications  Environment  Plus  (TAE  Plus),  a  U.ser  Interface 
Management  System  (UIMS). 


Figure  1 :  BGLCSS  2.0  Within  the  NTCS-A  System  Architecture 

TAE  Plus  is  a  visual  graphical  user  interface  builder  developed  by  the  National 
Aeronautics  and  Space  Administration  Goddard  Space  Flight  Center  (NASA  GSFC)  and 
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distributed  by  NASA’s  Computer  Software  Management  and  Information  center 
(COSMIC),  a  non-profit  unit  of  the  University  of  Georgia.  It  supports  rapid  building, 
tailoring,  and  management  of  graphic-oriented  user  interfaces.  The  main  features  of  TAE 
Plus  include:  1)  the  Work  Bench,  an  interactive  tool  that  supports  the  design  and  layout  of 
an  application’s  interface;  2)  the  Window  Programming  Tools  (Wpt)  Package,  a  set  of 
application  callable  subroutines  used  to  control  a  u.ser  interface  during  execution  time;  and 
3)  the  Code  Generator,  which  automatically  generates  code  for  the  interface  in  C,  C++, 
Ada,  or  TCL  (TAE  Command  Language)  [NASA  91a]. 

This  thesis  deals  with  the  design,  implementation,  maintenance,  and  extension  issues 
of  structured  programming  versus  object-oriented  programming  for  real-world  applications 
such  as  the  BGLCSS  tactical  decision  aid  within  the  NTCS-A  Unified  Build. 

B,  OBJECTIVES 

This  thesis  was  embarked  upon  to  determine  whether  there  are  significant  differences 
between  the  structured  and  the  object-oriented  implementation  of  the  same  application.  The 
object-oriented  paradigm  promises,  among  other  things,  a  more  reliable  end  product,  easier 
maintenance,  and  easier  extension.  We  seek  to  demonstrate  the  benefits  of  using  an  object- 
oriented  approach  for  a  real-world  application  such  as  BGLCS  and  to  argue  that  an  object- 
oriented  approach  is  particularly  suited  for  large,  multi-component  systems  such  as  the 
applications  within  the  NTCS-A  Unified  Build. 

C.  SCOPE 

The  Navy  Space  and  Warfare  Command  (SPAWAR)  project  specifications  demanded 
that  BGLCSS  2.0  be  written  in  C  using  a  structured  programming  paradigm.  While  much 
of  this  project  has  been  devoted  to  developing  robust  algorithms  to  realistically  simulate  the 
logistics  events  in  C,  this  thesis  critiques  the  use  of  the  structured  programming  paradigm, 
especially  in  large  systems. 

The  decision  to  use  a  visual  graphical  user  interface  UIMS  such  as  TAE  Plus  instead 
of  the  Wizard  Tool  Kit.  a  set  of  low-level  Motif  functions,  significantly  decreased  overall 
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development  time.  Furthermore,  we  propose  that  by  using  TAE  Plus  with  C++,  NTCS-A 
applications  could  benefit  significantly  not  only  from  improved  software  development 
time,  but  also  from  improved  product  reliability,  improved  program  maintenance,  and 
easier  program  extension.  Due  in  large  part  to  the  breadth  of  the  BGLCSS  application,  only 
a  subset  of  the  structured  paradigm  implementation  has  been  re-designed  using  an  object- 
oriented  paradigm  in  C++. 

D.  ORGANIZATION 

Chapter  II  of  this  thesis  provides  an  overview  of  the  structured  programming  and  the 
object-oriented  paradigms.  Chapter  III  presents  an  abbreviated  presentation  cf  the 
BGLCSS  2.0  graphical  user  interface  design  using  TAE  Plus.  Chapter  IV  covers  and 
analyzes  the  structured  design  and  implementation  of  the  structured  programming  version 
of  BGLCSS  in  C.  Chapter  V  covers  and  analyzes  the  object-oriented  programming  design 
of  BGLCSS  in  C++.  Chapter  VI  summarizes  the  work  accomplished  and  provides 
recommendations  for  program  maintenance  and  extension.  The  appendices  contain  the 
graphical  user  interface  panels,  the  C  and  C++  program  listings. 
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II.  BACKGROUND  OF  THE  PROGRAMMING  PARADIGMS 

A.  GENERAL 

Discussion  about  the  merits  of  object-oriented  programming  have  inundated  technical 
journals  over  the  past  few  years  and  has  appeared  even  in  non-technical  journals.  In  a  recent 
article  in  Business  Week  the  question  was  asked,  “Will  object-oriented  prograrruning 
transform  the  computer  industry?”  The  article  goes  on  to  describe  in  layman’s  terms  the 
differences  between  “the  old  way”,  i.e.  structured  programming,  and  “the  new  way”,  i.e. 
object-oriented  programming,  of  designing  and  writing  programs.  Structured  programming 
was  characterized  by  three  terms:  confusion,  hand  crafting,  and  breakdowns.  In  contrast, 
object-oriented  programming  was  described  by  three  counterpart  terms:  understanding, 
reusing,  and  repairing  [HAMMONDS  91]. 

Not  all  supporters  of  the  object-oriented  paradigm  agree  that  there  is  a  sharp  boundary 
between  “the  old  way”  and  “the  new  way.”  Rather,  object-oriented  principles  can  be  said 
to  have  evolved  from  the  lessons  learned  from  years  of  structured  programming  just  as 
structured  programming  principles  have  evolved  from  the  lessons  learned  from  years  of 
machine  and  assembly  language  programming.  Holub,  for  example,  cautions  against 
looking  for  the  “major  shift  in  paradigm”  promised  by  some  object-oriented  paradigm 
enthusiasts.  In  his  book  about  programming  with  objects  in  C  and  C-*-+,  he  introduces 
object-oriented  principles  by  using  code  written  in  C  within  a  structural  programming 
paradigm,  followed  by  code  written  in  C  within  an  object-oriented  paradigm,  and  finally 
the  object-oriented  C-t-+  version.  He  believes  that  object-oriented  programming  is  merely  a 
collection  of  useful  programming  techniques  that  can  be  applied  to  any  computer  language. 
An  “object-oriented  language”  provides  a  few  built-in  mechanisms  for  operations  that  can 
be  performed  explicitly  in  a  non-OOP  language.  Holub  even  argues  that  a  program  can  be 
written  in  C  in  an  object-oriented  way  just  as  easily  as  a  program  written  in  C+-(-  and 
provides  ample  examples  of  code  written  in  C  that  mimic  some  object-oriented  principles 
[HOLUB  92].  It  is  not  enough,  however,  that  a  program  be  written  in  an  object-oriented 
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way  in  C  as  in  C++.  Much  of  this  code  is  very  difficult  for  C  and  C++  programmers  alike 
to  understand  even  though  they  are  accustomed  to  reading  C  code  within  a  structured 
programming  paradigm,  the  paradigm  for  which  it  was  designed.  Using  a  structured 
programming  language  to  perform  object-oriented  techniques  is  a  less  than  optimal  fit  of 
resources  and  is  not  the  best  application  of  the  object-oriented  paradigm. 

It  can  even  be  argued  that  C++,  while  designed  to  support  object-oriented 
programming,  may  not  be  the  best  language  for  object-oriented  programming.  Shiffman 
[SHIFFMAN  92]  maintains  that  the  pure  object-oriented  programming  language  Smalltalk 
is  far  easier  to  use  than  C++.  With  Smalltalk,  it  is  possible  to  write  more  comprehensible, 
more  maintainable  programs  and  class  reuse  between  applications  is  far  more  prevalent  in 
contrast  to  C++.  Given  the  SPAWAR  project  specifications  to  use  C  to  implement 
BGLCSS  2.0,  the  advantages  of  using  a  pure  object-oriented  programming  language  such 
as  Smalltalk  are  outweighed  by  the  benefits  of  using  C++.  A  move  to  C++,  because  it  is  a 
superset  of  C,  provides  a  more  evolutionary  transition  to  an  object-oriented  paradigm  than 
moving  from  C  to  an  entirely  different  language  with  its  own  syntax  and  conventions. 

B.  GOALS  OF  SOFTWARE  DEVELOPMENT 

To  distinguish  between  these  two  paradigms  and  determine  whether  or  not  the  object- 
oriented  programming  paradigm  is  better  than  the  structured  programming  paradigm,  we 
need  to  identify  specific  goals  of  good  software  development.  Meyer  [MEYER  88]  cites 
several  “quality  factors”  of  software  development;  correctness,  robustness,  extendibility, 
and  reusability.  Correctness  is  defined  as  the  ability  of  software  to  exactly  perform  its  tasks, 
as  defined  by  the  requirements  and  specifications.  Robustness  refers  to  the  ability  of 
software  to  function  even  in  unintended  conditions.  Extendibility  is  a  subjective  measure 
of  the  ease  with  which  a  program  can  be  changed  to  conform  to  a  change  in  program 
specifications.  For  instance,  a  simple  design  is  easier  to  adapt  to  specification  changes  than 
a  complex  one.  Furthermore,  the  more  autonomous  or  decentralized  the  program  modules, 
the  higher  the  probability  that  a  simple  change  will  affect  just  one  module  rather  than 
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trigger  off  a  chain  of  reaction  of  changes  over  the  whole  system.  Finally,  reusability  is  the 
ability  of  software  to  be  reused,  in  whole  or  part,  for  new  applications  and  thereby 
significantly  reduce  development  costs.  With  these  software  goals  in  mind,  we  can  now 
discuss  the  extent  to  which  each  paradigm  addresses  these  goals. 

C.  STRUCTURED  PROGRAMMING  PARADIGM 

Machine  and  assembly  languages  reflect  the  architecture  of  the  machines  on  which 
they  operate.  Like  these  machines,  they  are  composed  of  data,  arithmetic  expressions, 
assignments  to  memory  locations,  and  control  flow.  Among  the  problems  associated  with 
using  these  languages  to  develop  software  are  the  difficulties  in  debugging  problematic 
code  and  the  high  cost  of  this  tedious  process.  These  problems  were  part  of  the  impetus 
behind  the  development  of  higher-level  languages  such  as  Fortran  and  later,  C.  The  C 
programming  language  has  been  described  as  a  higher-level  language  that  “rebuilds”  an 
underlying  machine  to  make  it  more  convenient  for  programming  [SETHI  90].  In  general, 
the  development  of  programming  languages  from  the  first  generation  languages  to  the 
current  generation  of  languages  has  been  a  continual  search  for  improved  correctness, 
robustness,  extendibility,  and  reusability.  Five  characteristics  of  the  structural 
programming  paradigm  are  of  interest  to  our  discussion:  separate  code  and  data,  built-in 
data  types,  top-down  functional  decomposition  and  function-based  design,  distributed 
functionality,  and  limited  code  reuse. 

1.  Separate  Code  and  Data 

Procedures  and  functions  operate  on  data  and  are  defined  and  coded  separate  from 
each  other  (see  Figure  2).  This  is  particularly  apparent  in  pre-ANSI  C  programs  (see 
Appendix  A).  The  data  structures  and  simple  data  types  are  usually  defined  in  header  files, 
i.e.  files  with  a  “.h”  at  the  end  of  the  file  name.  The  functions  that  operate  on  the  data  are 
usually  defined  in  separate  files  with  a  “.c”  at  the  end  of  the  file  name.  When  a  driver 
program  uses  these  functions  and  data,  it  is  necessary  to  indicate  to  the  C  compiler 
preprocessor  to  put  a  copy  of  the  header  file  in  the  driver  program  file  when  compilation 
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occurs.  Separately,  the  names  of  functions  found  outside  of  the  main  program  are  declared 
to  be  external  to  the  file.  The  names  of  procedures  or  functions  and  global  data  must  be 
unique  so  that  they  do  not  conflict  with  one  another.  TTiere  are  two  problems  with  the 
separation  of  these  program  components.  First,  procedures  and  functions  can  be  called  and 
passed  the  wrong  data.  Second,  by  unintentionally  accessing  data  from  procedures  and 
functions,  changes  to  data  become  uncontrollable  in  large  systems  where  no  one  knows 
where  a  particular  data  item  is  being  changed  or  why.  These  two  weaknesses  associated 
with  the  separation  of  code  and  data  frequently  reduces  program  correctness  and 
robustness. 


Figure  2:  Structural  Program  Procedures  Separate  From  Data 

2.  Built-In  Data  Types 

While  most  languages  implement  integers  and  floating  point  numbers  as  built-in 
types,  most  do  not  implement  complex  numbers,  calculations  with  physical  units  (barrels, 
tons,  etc.),  date  time  groups,  and  latitudes/longitudes.  If  these  types  are  needed,  they  cannot 
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be  added  easily.  There  are  two  problems  with  being  limited  to  built-in  data  types.  First, 
libraries  become  long  lists  of  specialized  functions  rather  than  general  functions  handling 
a  variety  of  types.  The  GOTS  library  is  a  case  in  point  [INRI  92b].  It  contains  numerous 
functions  that  perform  conversions  from  one  built-in  data  type  to  another  as  shown  in  Table 
1.  This  library  is  a  proliferation  of  very  specific  functions  that  convert  one  built-in  type 
representation  of  a  real-world  entity  to  another  built-in  type  representation. 

Table  1:  A  SAMPLE  OF  GOTS  DATA  CONVERSION  ROUTINES 


Function 

Description 

Arguments 

Return  Type 

dtg 

date  time  group  string  to  inte¬ 
ger 

char  tme[] 

int 

dtg_to_a 

integer  value  of  time  to  date 
time  group  string 

int  one 

char* 

lat_to_A 

double  value  of  latitude  to  lati¬ 
tude  string 

double  lat 

char* 

il_to_A 

double  values  of  latitude  and 
longitude  to  latitude/longi¬ 
tude  string 

double  lat.  double  Ing 

char* 

Since  each  GOTS  library  function  requires  the  data  type  of  the  function 
arguments  to  be  specified  and  only  built-in  types  are  allowed,  it  is  difficult  to  write  more 
general  and  therefore  flexible  library  functions.  This  undermines  reusability  of  the  library 
functions.  Second,  it  is  possible  to  perform  meaningless  operations  on  the  real  world  data 
being  modelled.  As  an  example,  a  date  time  group  is  often  represented  as  an  integer  and  yet 
it  is  still  possible  to  add  two  date  time  groups  together.  This  contributes  to  a  poor 
representation  of  the  real-world  entity  being  modeled  in  software. 

3.  Top-Down  Functional  Decomposition  and  Function-Based  Design 

The  top-down  functional  approach  to  program  design  is  based  on  the  premise  that 
software  development  should  be  an  incremental  refinement  of  the  system’s  abstract 
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function  rather  than  the  data  it  represents  in  the  real  world.  This  process  has  often  been 
described  as  a  tree  where  the  nodes  of  the  tree  represent  elements  in  the  decomposition  and 
the  branch  nodes  represent  a  refinement  of  its  parent  node.  The  primary  benefits  of  the  top- 
down  functional  approach  is  that  it  is  logical  and  promotes  organization  and  discipline. 
However,  it  fails  to  account  for  the  evolutionary  nature  of  software  system  development. 
Additionally,  by  focusing  on  the  function  rather  than  the  data,  a  top-down  approach  does 
little  to  promote  reusability.  During  the  life  of  the  system,  it  is  the  data  and  not  the  functions 
that  are  the  most  stable  part  of  a  system.  The  trade-off  with  this  top-down  approach  is  that 
it  is  fairly  easy  to  design  and  develop  an  initial  structure  for  the  short  term.  However,  in  the 
long-run,  as  the  system  changes,  it  will  be  necessary  to  constantly  redesign  the  system 
instead  of  merely  extending  the  system.  By  focusing  on  the  data  instead  of  the  immediate 
purpose  of  the  system,  the  long-term  benefits  of  reusability  and  extendibility  can  be 
achieved  [MEYER  88]. 

Whether  or  not  top-down  design  is  used,  structural  programs  are  primarily 
function-based.  Bottom-up  design  involves  finding  a  set  or  sets  of  fundamental  operations 
that  are  used  throughout  the  program  and  writing  procedures  or  functions  to  implement 
them.  A  top-down  approach  is  then  often  used  to  connect  the  routines.  In  either  a  top-down 
or  bottom-up  approach,  the  emphasis  is  on  the  data  upon  which  the  program  operates. 

4.  Distributed  Functionality 

Procedures  and  functions  tend  to  be  tightly  coupled  using  this  paradigm.  That  is, 
procedures  and  functions  are  distributed  throughout  a  program  and  tend  to  know  too  much 
about  other  procedures  and  functions.  Changes  to  one  function  may  force  changes  in  other 
functions.  If,  for  instance,  a  new  ship  type  such  as  the  USS  Arleigh  Burke  class  needs  to  be 
incorporated  into  a  program,  all  of  the  functions  regarding  ship  type  will  need  to  be 
modified.  Since  these  functions  are  hard-coded  into  the  structure  of  a  program,  program 
extension  becomes  much  more  difficult  to  perform. 
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5.  Limited  Code  Reuse 

The  structured  paradigm  inherently  leads  to  repetition  in  programming.  By  using 
built-in  data  types  and  function-based  design,  code  reuse  can  be  achieved  only  by  the  low 
level  method  of  cutting  and  pasting  code  from  one  program,  and  explicitly  modifying  it  for 
its  new  data  type  (see  Appendix  A,  InsertBGEvent,  InsertBGHeader,  and  InsertBGHeader 
functions).  Conventional  languages  require  general  purpose  libraries  which  are  limited  to 
a  long  list  of  special  purpose  sort  routines  for  sorting  arrays  of  integers,  floats,  etc.,  instead 
of  a  generic  sort  function  that  is  data-type  independent. 

D.  OBJECT-ORIENTED  PROGRAMMING  PARADIGM 

The  object-oriented  programming  paradigm  is  a  software  design  and  development 
model  incorporating  several  techniques  explicitly  aimed  at  code  reuse,  improved  program 
reliability,  and  easier  software  modification,  extension,  and  maintenance.  The  object- 
oriented  programming  paradigm  is  particularly  well  suited  for  the  development  of  large 
sophisticated  software  systems  that  inherently  evolve  over  time.  Characteristics  associated 
with  the  object-oriented  paradigm  include  encapsulation,  data  abstraction,  inheritance, 
polymorphism,  persistence,  delegation,  and  generacity.  The  first  four  characteristics  are 
supported  by  the  2. 1  version  of  C+-(-,  and,  since  C++  was  the  language  chosen  to  design  a 
subset  of  BGLCSS  2.0,  this  thesis  will  concentrate  only  on  encapsulation,  data  abstraction, 
polymorphism,  and  inheritance  issues.  Generacity,  a  characteristic  added  to  C++  version 
3.0  and  also  known  as  parametric  polymorphism,  will  be  briefly  mentioned.  Although 
encapsulation  and  data  abstraction  are  used  within  other  paradigms,  it  will  be  shown  that 
they  are  far  more  powerful  within  an  object-oriented  paradigm  than  within  a  structured 
programming  paradigm. 

How  does  the  object-oriented  paradigm  lead  to  a  more  reliable  end  product,  and  easier 
software  modification,  extension,  and  maintenance?  In  general,  the  process  begins  by 
producing  a  more  realistic  representation  of  the  real  world  entities  involved.  For  example, 
by  combining  ship  functions  and  ship  data  into  a  ship  object,  the  real  world  ship  entity  is 
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more  coherently  represented  in  code.  An  object  is  defined  in  terms  of  the  data  it 
encapsulates  and  the  operations  on  the  data  that  are  allowed  by  the  set  of  interface  functions 
(see  Figure  3). 


"Name  | 

HullNumber 

~F/6Capacity  | 

Other  Data... 

_ Private  members _ 

Public  functions _ 

GetName 

GetHullNumber 

ComsumeF76Fuel 

Other  Functions . 

Ship  Object 

Figure  3;  Object  Encapsulating  Related  Functions  and  Data 

A  real  world  ship  has  attributes  such  as  its  name,  hull  number,  F-76  fuel  capacity,  etc., 
and  can  perform  various  functions  such  as  stationing,  changing  course  and  speed,  etc.  Ship 
attributes  and  the  functions  it  can  perform  are  said  to  be  encapsulated  within  a  ship  object. 
The  operations  that  can  be  performed  on  the  encapsulated  data  are  also  known  as  the 
object’s  interface  functions  and  the  implementation  of  these  functions  is  internal  to  the 
object.  For  example,  a  ship  object  frequently  changes  its  course  and  speed  which  affects  its 
internal  fuel  consumption  and  levels.  These  are  attributes  internal  to  the  definition  of  a  ship 
object. 

Encapsulation  allows  for  information  hiding  and  the  object-oriented  paradigm’s 
method  of  information  hiding  goes  beyond  local  variables.  Information  hiding  protects  data 
from  uncontrolled  access  and  change.  Variables  that  are  local  to  a  procedure  or  function. 
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for  instance,  can  only  be  changed  within  the  function  or  procedure.  In  this  way,  they  are 
protected  from  access  from  other  functions  and  procedures.  Global  variables,  on  the  other 
hand,  are  vulnerable  to  unintended  change  or  access  by  the  functions  and  procedures  in 
their  scope. 

Objects,  in  C++,  can  have  data  or  function  members  which  are  declared  to  be  either 
public,  protected,  or  private.  These  terms  refer  to  the  level  of  access  to  these  members.  For 
instance,  all  of  a  ship’s  data  members  can  be  declared  to  be  private  to  the  rest  of  the 
program.  In  this  case,  only  a  ship’s  member  function  can  access  private  data  to  that  object. 
Instead  of  passing  variables  to  functions,  it  is  the  variables  that  are  receiving  messages  in 
the  form  of  functions.  The  variables  themselves  are  designed  to  control  which  functions  can 
modify  which  variables  in  the  program. 

1.  Data  Hiding  and  Data  Abstraction 

Data  hiding  is  a  practice  whereby  the  programmer  restricts  him  or  herself  to  the 
public  interface  of  a  type  for  purposes  of  accessing  or  changing  the  value  of  an  object  of 
that  type.  The  advantage  of  data  hiding  is  that  it  encourages  the  programmer  to  protect  data 
from  unintended  access  and  modification. 

Data  abstraction  is  defined  as  the  activity  of  creating  a  model  or  concept  of  a  real- 
world  phenomenon  at  such  a  level  that  inessential  details  can  be  ignored.  It  is  data  typing 
combined  with  data  hiding.  In  C++,  the  programmer  creates  user-defined  types  using  the 
class  mechanism.  Abstract  data  types  in  C++  are  not  built-in  data  types  such  as  integers  or 
floating  point  numbers  but  are  treated  as  though  they  were  built-in.  The  term,  user-defined 
data  type,  is  a  more  appropriate  term.  C++  is  an  extensible  language  in  that  the  language 
can  be  extended  to  include  user-defined  data  types. 

There  are  two  benefits  to  data  abstraction.  First,  it  is  easier  to  design  and 
implement  a  system  that  is  built  out  of  entities  that  incorporate  data  hiding.The  focus  can 
be  on  the  properties  of  the  procedural  interface  of  the  various  entities.  These  properties  are 
typically  far  simpler  and  more  abstract  than  the  algorithms  that  implement  them.  Second, 
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the  decoupling  of  the  interface  from  the  implementation  allows  program  entities  to  be 
reimplemented  without  having  to  modify  any  other  part  of  the  program.  C++’s  most 
important  abstract  data  type  is  the  class. 

a.  Class 

A  class  is  an  internal  template.  In  C++,  it  is  the  extension  of  a  C  struct.  A 
struct  (in  other  programming  languages,  it  is  known  as  a  record)  is  a  group  of  several 
different  types  of  data  in  a  single  entity.  An  object  is  actually  an  instance  of  a  class  that 
occupies  memory.  For  example,  a  class  could  be  used  to  represent  a  ship.  Although  the 
actual  data  structure  of  a  class  is  basically  a  struct  with  functions  associated  with  it,  it  is 
considered  as  a  single  entity.  A  definition  of  a  class  in  a  C++  program  conceptually 
introduces  a  new  type  into  the  language.  The  most  significant  feature  of  a  class  is  that 
objects  of  the  class  can  be  treated  the  same  way  objects  of  a  fundamental  type  such  as 
integer  [HOLUB  92]. 

b.  Member  Functions 

A  C++  class  differs  from  a  struct  in  C  in  that  it  contains  member  functions  as 
well  as  data.  The  member  function  can  be  declared  inside  the  class  body,  but  are  usually 
declared  in  a  prototype  form  in  the  class  definition  and  are  defined  later  on.  The  need  for 
member  functions  is  related  to  data  hiding  mentioned  earlier.  Member  functions  can  access 
private  member  data  values.  Member  functions  are  one  way  to  work  with  private  data. 
Putting  the  member  functions  and  member  data  together  makes  the  data  active  and  more 
cohesive. 

c.  C++  Constructors  and  Destructors 

C++  provides  constructor  and  destructor  functions  and  almost  every  class 
contains  these  special  member  functions.  They  initialize  and  clean  up  class  objects. 
Constructors  provide  a  way  to  ensure  that  objects  are  defined  with  initial  values  without 
violating  the  constraints  of  data  hiding.  Destructors  are  important  to  free  up  object  memory 
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that  was  allocated  by  the  constructor.  A  class  can  have  several  different  constructors  to 
allow  objects  to  be  able  to  be  initialized  in  different  ways  with  different  argument.  One  of 
the  greatest  advantages  of  constructors  and  destructors  is  that  they  simplify  software 
maintenance.  If,  for  instance,  the  specification  for  the  format  for  ship  hull  numbers  were  to 
be  changed,  only  the  class  member  data  and  functions  would  be  changed.  In  structured 
programmirg,  a  “simple”  change  such  as  this  one,  can  change  hundreds  or  even  thousands 
of  lines  of  code  that  are  closely  tied  to  the  format  of  the  data  [PERRY  92]. 

2.  Inheritance  and  Class  Relationships 

Inheritance  is  used  to  describe  special  relationships  between  classes.  It  is 
generally  used  to  achieve  two  goals:  1 )  It  can  be  used  as  an  abstraction  tool  to  organize 
classes  into  hierarchies  of  specialization;  and  2)  It  can  be  used  as  a  code  reuse  mechanism 
to  create  a  new  class  that  bears  strong  resemblance  to  an  exi.sting  class  with  added 
refinements. 

In  the  first  case,  inheritance  reflects  a  semantic  relationship  between  classes 
where  one  class’s  member  functions  are  used  to  refine  some  attributes  of  an  existing  base 
class  while  inheriting  the  remaining  attributes.  This  form  of  inheritance  could  also  be  a 
mechanism  to  embody  the  strong  similarities  between  two  existing  abstractions  such  that 
an  object  of  a  base  class  can  be  interchanged  by  an  object  of  a  derived  class.  The  ability  of 
a  program  to  handle  many  forms  of  a  class  as  though  they  were  the  same,  an  example  of 
polymorphism,  which  is  further  discussed  in  the  next  section,  is  an  important  abstraction 
tool  that  shields  the  programmer  from  the  implementation  details  of  derived  classes. 

In  the  second  ca.se,  inheritance  is  used  to  share  code.  While  a  class  may  not  exhibit 
all  the  properties  of  its  base  class,  it  may  be  similar  enough  that  the  reuse  gains  make 
inheritance  worthwhile.  For  example,  although  an  ASW  threat  level  event  and  a  raH  event 
are  not  interchangeable,  they  may  have  enough  code  in  common  that  a  common  evolution 
through  inheritance  could  lead  to  code  sharing. 
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Coplien  identifies  four  specific  reJationships  between  classes  that  affect  class 
design  and  class  hierarchy  design;  the  is  a,  has  a,  uses  a,  and  creates  a  relationships.  The 
is  a  relationship  is  one  where  specialization  or  subtyping  is  involved.  A  destroyer  is  a  type 
of  ship  and  therefore,  a  destroyer  class  could  be  derived  from  a  ship  class.  Another 
relationship  between  classes  is  called  composition  or  a  has  a  relationship.  For  example,  a 
ship  has  a  F-76  fuel  state.  Composition  is  implemented  by  either  designating  one  class  as 
a  member  of  another  or  by  one  class  referencing  another  object.  A  uses  a  relationship 
exists  when  a  member  function  of  a  class  takes  an  instance  of  some  other  class  and  uses  it 
as  a  parameter.  A  uses  a  relationship  exists  when  one  class  member  functions  calls  on  the 
services  of  some  other  class.  A  creates  a  relationship  is  similar  to  a  uses  a  relationship  but 
it  is  between  an  object  and  a  class  instead  of  between  objects.  In  other  words,  an  instance 
of  one  class,  during  the  execution  of  one  of  its  member  functions,  makes  a  request  of  some 
other  class  to  create  an  instance  of  an  object  of  the  class.  The  identification  of  these 
relationships  significantly  influences  the  details  of  class  design  and  class  hierarchy  design 
[COPLIEN  92]. 

Class  hierarchy  design  can  take  on  two  different  forms;  single  or  multiple 
inheritance.  Single  inheritance  allows  the  creation  of  a  new  class  by  using  an  existing  class 
as  a  model.  In  other  words,  it  is  possible  to  inherit  one  class  from  another,  creating  new 
classes  from  existing  ones.  The  original,  or  base  class,  shares  its  code  with  the  new  class. 
Code  sharing  can  make  programming  much  easier  because  le.ss  code  needs  to  be  rewritten. 
In  some  cases,  new  features  need  only  be  added  to  the  new,  derived  classes.  Multiple 
inheritance,  by  contrast,  is  the  creation  of  a  new  class  from  multiple  existing  classes.  C++ 
implements  both  single  and  multiple  inheritance. 

3.  Polymurphism 

When  writing  C++  programs,  the  same  function  name  can  be  used  with  different 
types  of  objects.  Polymorphism  means  “many  different  forms.”  Perry  asserts  that 
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polymorphism  is  one  reason  why  C++  programs  can  be  written  faster  than  C  programs.  For 
instance,  in  C++,  various  objects  can  be  printed  out  with  the  same  function  name; 

Ship .print () ;  //  Prints  the  Ship  object 

BGEvent .print () ;  //  Prints  the  BGEvent  object 

By  using  the  same  function  name  for  different  objects  to  perform  the  same 
operation  such  as  printing,  the  “clutter”  is  removed  from  the  code.  There  is  no  need  to  name 
the  functions  specific  to  the  data  type  being  manipulated  as  shown  in  the  following  C  code; 

PrintShip();  /*Prints  a  Ship  data  structure*/ 

Pr intBGEvent  ( )  ;  /*P;.  ints  a  BGEvent  data  structure*/ 

On  the  surface,  the  ability  to  use  the  same  function  name  print()  for  several 
different  objects  merely  seems  to  be  a  syntactic  advantage  of  removing  “clutter.”  However, 
what  is  really  happening  is  that  the  same  message  or  function  name  causes  different 
responses  depending  on  which  object  is  receiving  the  message.  One  benefit  of 
polymorphism  is  that  it  models  the  real  world  object  better  than  the  structured  paradigm  by 
using  one  command  to  be  issued  to  different  objects. 

With  polymorphism,  each  time  a  new  object  is  added  to  a  program,  no  changes  to 
the  existing  code  are  required.  All  that  is  required  is  that  a  new  function  is  added  to  the 
object.  Therefore,  polymorphism  facilitates  program  extension  by  eliminating  the  need  to 
alter  the  existing  program  code. 

Parametric  polymorphism,  a  mechanism  supported  by  C++  3.0  as  templates,  has 
been  argued  to  be  the  mechanism  allowing  for  the  highest  degree  of  code  reu.se  of  all  of  the 
object-oriented  mechanisms.  Templates  in  C++  are  similar  to  generic  packages  in  Ada. 
Templates  define  families  of  types  and  functions.  They  are  an  alternative  to  inheritance 
hierarchies  constructed  for  code  reu.se.  For  example,  a  template  J.;  in  be  designed  to 
implement  a  doubly  linked  list  and  can  be  used  for  any  type.  Thi  k  i  .  ■  '  n  use  is  based  on 
the  reuse  of  source  code  rather  than  object  code.  By  contrast,  much  ol  the  functionality  of 
a  base  class  can  be  reused  by  a  derived  cla.ss  at  the  object  code  level.  Template  classes  can 
be  used  to  build  generic  class  libraries. 
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E.  COMPARISON  OF  THE  PARADIGMS 


In  comparing  the  two  paradigms,  it  is  useful  to  point  out  each  paradigm’s  strengths 
and  weaknesses  in  order  to  determine  which  paradigm  contributes  more  to  the  goals  of 
software  engineering  as  described  by  Meyer,  i.e.  correctness,  robustness,  extendibility,  and 
reusability. 

The  strengths  of  the  structured  programming  paradigm  are  limited.  First,  in 
comparison  to  developing  code  in  an  ad  hoc  manner,  structured  programming  and  the  top- 
down  functional  decomposition  approach  provides  organization  to  complex  system 
development.  Fortran,  assembly  language,  and  machine  code  programming  pale  in 
comparison  to  code  written  using  a  structured  programming  paradigm. 

The  weaknesses  of  this  paradigm,  however,  are  numerous.  First,  by  separating  the 
code  from  the  data,  there  is  the  possibility  of  passing  the  wrong  data  to  the  code  and  data 
can  be  accessed  and  changed  in  uncontrollable  ways.  This  reduces  the  correctness  and  the 
robustness  of  a  program.  Second,  most  languages  associated  with  the  structured 
programming  paradigm  are  limited  to  built-in  data  types  with  the  exception  of  Ada  and 
Modula-2.  In  general,  the  ability  to  create  a  general  library  of  functions  results  in  either  a 
proliferation  of  library  functions  or  the  lack  of  them.  This  weakness  affects  reusability. 
Also,  meaningless  operations  such  as  addition  can  be  performed  on  entities  such  as  a  date 
time  group.  Third,  the  down  side  of  a  top-down  functional  decomposition  approach  is  that 
it  inherently  leads  to  requiring  repeated  redesigns  when  program  extensions  are  required. 
Fourth,  with  functionality  distributed  throughout  a  program,  changes  to  one  function  may 
force  changes  to  other  functions.  This  compromises  program  extension  efforts  as  well  as 
program  correctness  and  robustness. 

The  object-oriented  programming  paradigm  provides  more  techniques  to  achieve  the 
software  goals  of  correctness,  robustness,  extendibility,  and  reusability  than  in  the 
structured  programming  paradigm.  It  can  be  said  that  some  elements  of  the  structured 
programming  paradigm  have  been  incorporated  within  the  object-oriented  programming 
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paradigm.  An  obvious  example  is  the  emphasis  on  an  organized,  top-down,  high-level 
approach  to  design. 

Although  data  abstraction  and  data  hiding  are  supported  in  the  structured 
programming  paradigm,  they  are  more  powerful  within  the  object-oriented  paradigm.  The 
primary  reason  for  this  stems  from  the  combination  of  data  and  functions  within  an  object 
of  a  class.  The  object  of  a  class  provides  a  more  realistic  representation  of  the  real-world 
entity  and,  when  used  within  a  program,  limits  the  degree  to  which  a  change  in  an  object’s 
data  or  functions  affects  other  parts  of  the  program  and  forces  a  cascade  of  changes. 
Polymorphism,  a  technique  used  when  calling  functions  of  the  same  name  for  objects  of 
different  classes,  makes  program  code  easier  to  read.  Template  classes,  a  C++  feature  to 
create  generic  classes,  allows  the  building  of  truly  general  class  libraries  which  is  not 
possible  with  a  structured  programming  paradigm. 
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III.  BGLCSS  2.0  GRAPHICAL  USER  INTERFACE  DESIGN 


A.  TAE  PLUS  OVERVIEW 

The  TAE  Plus  version  5.2  beta  release  was  developed  under  SunOS  4.1.1  on  a 
SPARCstation  2.  Components  used  to  develop  TAE  Plus  include  Release  4  of  the  X 
Window  System  (XI 1R4),  Open  Software  Foundation  (OSF)  OSF/Motif  1.1.4,  Interviews 
2.6  from  Stanford  University;  and  GNU  g++  version  i.40.3.  As  far  as  C++  code  generation 
is  concerned,  the  TAE  Plus  installation  source  code  tree  was  subsequently  rebuilt  to  link 
statically  with  SunC++  2.1.  While  the  above  components  constitute  the  only  officially 
supported  platform  for  this  beta  release,  TAE  Plus  version  5.2  beta  was  also  tested  with 
OSF/Motif  1.1.3.  The  TAE  Plus  installation  guide  urges  users  to  upgrade  to  OSF/Motif 
1.1.4  (or  1.1.3)  as  soon  as  possible  to  take  advantage  of  the  many  problems  fixed  by  OSF. 
However,  the  release  of  TAE  Plus  used  for  this  thesis  is  expected  to  work  with  versions 
1.1.1  and  1.1.2  of  OSF/Motif  as  well,  although  behavior  may  vary  [NASA  92b]. 

TAE  Plus  is  a  graphical  user  interface  builder  used  at  three  different  levels.  First,  it  is 
used  at  the  WorkBench  level  as  shown  in  Figure  4  to  visually  design  panels  (windows)  and 
items  (buttons,  selection  lists,  labels  etc.). 


Figure  4;  TAE  Pius  WorkBench  Panel 
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Also  at  this  level,  panels  and  items  are  named,  defined,  and  various  constraints  and 
details  such  as  whether  or  not  the  item  is  an  “event-generating”  one,  are  added.  The  term 
“event- generating”  should  not  be  confused  with  the  battle  group  events  simulated  in 
BGLCSS  2.0.  An  item  is  event-generating  if  it  causes  another  panel  to  be  displayed  or  if  a 
call  to  a  function  is  made.  At  this  point,  all  of  the  information  created  for  an  interface  is 
contained  in  a  resource  file.  The  format  for  the  name  of  a  resource  file  is  the  application 
name  appended  by  a  .res  suffix  (see  Figure  5). 


Figure  5:  TAE  Plus  WorkBench  Resource  File  Selection  Panel 

Second,  TAE  Plus  generates  code  for  all  of  the  event-generating  items  in  the 
application  panels.  While  an  in-depth  discussion  of  event-driven  programming  is  beyond 
the  scope  of  this  thesis,  it  is  important  to  understand  the  difference  between  an  event- 
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generating  item  and  a  non-event-generating  item.  An  event-generating  item  is  an  item  such 
as  a  button  or  a  selection  list  that,  when  pushed  or  when  an  item  is  selected,  another 
interface  activity  takes  place.  A  non  event-generating  item  is  an  item  such  as  a  text  keyin 
item  where  users  enter  data. 

Third,  at  the  source  code  level,  it  is  the  application  programmer’s  task  to  integrate  the 
calls  to  application  library  functions  with  the  code  generated  by  TAE  Plus.  When  this 
project  began,  TAE  Plus  Version  5.1  generated  only  Ada,  C,  and  TAE  Plus  Command 
Language  code.  In  the  meantime,  a  beta  version  of  TAE  Plus  was  released  providing  code 
generation  in  C-t-+.  Therefore,  it  was  possible  to  build  a  graphical  user  interface  and 
generate  C  code  for  the  structured  programming  version  of  BGLCSS  2.0  as  well  as  C-i-h 
code  for  the  object-oriented  programming  version  of  a  subset  of  BGLCSS  2.0.  The 
integration  at  the  source  code  level  will  be  discussed  in  chapters  IV  and  V  with  respect  to 
each  of  the  implementations:  in  C  and  in  C-l-^. 

B.  TAE  PLUS  WORKBENCH 

At  the  WorkBench  level,  the  first  step  in  creating  an  application  is  to  create  an  initial 
panel  and  to  define  the  panel’s  specifications  such  as  the  panel  for  the  battle  group  course 
and  speed  event  as  shown  in  Figure  6. 


Figure  6:  TAE  Plus  Panel  Specification  Panel 
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By  pressing  the  Edit  Panel  Details  button  on  the  panel  depicted  in  the  last  figure,  the 
Panel  Details  Panel  is  displayed  (see  Figure  7).  It  is  used  to  define  the  panel’s  help  file  and 
icon  details.  Applications  built  with  TAE  Plus  require  an  initial  panel(s)  to  be  designated 
as  in  the  BGEvents  module  of  BGLCSS  2.0  (see  Figure  8). 


Figure  7:  TAE  Plus  Panel  Details  Panel 


Figure  8:  TAE  Plus  Specify  Initial  Panels  Panel 


2.3 


Panels  can  be  connected  to  event-generating  buttons  or  calls  to  application  functions 
using  the  Connection  Specification  Panel  as  shown  in  Figure  9. 


Figure  9;  TAE  Plus  Connection  Specification  Panel 


Once  a  panel  is  created,  items  can  be  defined  and  added  to  the  panel  using  the  Item 
Specification  Panel  in  depicted  in  Figure  10.  When  an  item  is  defined,  one  of  its  most 
important  attributes  is  its  data  type.  Based  on  data  type,  TAE  Plus  provides  general  type 
checking  on  user-entered  data.  For  example,  if  an  item  is  defined  as  a  real  number,  and  the 
user  enters  anything  else,  i.e.  an  integer  or  a  string,  an  error  message  is  displayed  by  TAE 
Plus  to  the  user  indicating  that  the  data  type  is  invalid  and  restored  the  previous  entry.  This 
general  data  type  checking  provided  by  TAE  Plus  eliminates  the  need  to  write  error 
handling  routines  of  this  nature  by  the  applications  programmer. 
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Figure  10:  TAE  Plus  Item  Specification  Panel 


User  entered  data  can  be  further  restricted  by  setting  constraints  as  show  in  Figure  1 1 . 
For  instance,  a  constraint  on  the  range  of  valid  values  can  be  specified  on  a  text  keyin  real 
data  type  item.  A  course  heading,  in  the  real  world,  has  a  range  between  0.0  and  359.9. 
When  real  value  is  entered  that  falls  outside  of  the  specified  range,  an  error  message  is 
displayed  to  the  user  and  the  previous  value  is  restored  to  the  text  keyin  interface  item. 
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Figure  1 1 :  TAE  Plus  Item  Constraints  Panel 

TAE  Plus  also  makes  the  implementation  of  a  help  button  easy  to  define.  When  a 
button  is  defined,  the  specific  details  offered  to  the  designer  are  displayed  in  the  panel 
shown  in  Figure  12. 


Figure  12:  TAE  Plus  Push  Button  Presentation  Panel 

Furthermore,  application  specific  error  messages  can  be  defined  (see  Figure  13).  The 
message  item  provides  a  template  for  making  information,  warning,  and  error  messages. 
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Figure  13:  TAE  Plus  Message  Presentation  Panel 

C.  BGLCSS  2.0  GUI  DESIGN 

BGLCSS  2.0  consists  of  three  program  modules:  Setup,  Events,  and  Overview.  When 
integrated  into  the  NTCS-A  Unified  Build,  BGLCSS  2.0  is  one  of  several  JOTS  D  Tactical 
Decision  Aids  (TDAs)  as  shown  in  Figure  14. 


Figure  14:  JOTS  II  Menu  Tree 


Each  one  of  these  modules  was  built  using  three  separate  TAE  Plus  application  and  in 
accordance  with  the  User  Interface  Specifications  for  Navy  Command  and  Control  Systems 
[FERNANDES  92].  A  script  is  used  to  call  individual  JOTS  U  applications.  The  design 
decision  to  separate  BGLCSS  2.0  into  three  modules  was  based  on  the  way  simulation 


applications  are  used.  In  order  to  simulate  logistics  events,  it  is  a  prerequisite  to  define  some 
settings  and  create  the  entities  with  which  to  work.  By  dividing  BGLCSS  2.0  into  Set  Up, 
Events,  and  Overview,  the  user  is  directed  to  the  three  main  services  of  the  application. 
Once  set  up  is  performed,  events  can  be  simulated.  In  addition,  although  help  buttons  are 
present  on  every  panel  and  provide  clear  instructions  to  the  user  about  using  the  items  on  a 
specific  panel,  it  was  decided  to  include  an  Overview  module  where  a  “Help  on  Help”  on¬ 
line  user’s  manual  could  be  provided. 

Each  module’s  C  code  was  generated  by  TAE  Plus  based  on  the  initial  panel 
uesignated,  connections  between  items  and  panels,  and  items  designated  as  event¬ 
generating.  A  partial  depiction  of  the  files  generated  for  the  BGSetup  module  (see  Figure 
15). 


Figure  15:  TAE  Plus  Files  Generated  and  Function  Invocation  for  Setup  Module 

I 
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The  BGSetup.c  calls  two  functions,  BGSetup_Initialize_ALL_Panels  ()  found  in 
BGSetup_init_pan .  c  and  BGSetup_Create_InitiaLPanels{)  found  in 

BGSetup_creat_init  .c .  The  first  function  reads  the  resource  file  created  by  the 
TAE  Work  Bench  and  creates  and  initializes  the  TAE  objects  used  for  each  panel  in  the 
application.  The  second  function  merely  calls  the  specific  function  to  create  the  initial 
panel,  in  this  case,  SetUpBGs_Create_Panel()  found  in  pan_SetUpBGs  .  c  . 

After  calling  these  two  functions,the  main  event  handling  loop  runs  the  entire  program 
until  the  SET_APPLICATION_DONE  flag  is  set.  At  this  time,  the  program  terminates. 
During  the  main  event  loop,  the  functions  found  in  the  panels  NewBG,  BGData,  DelBG, 
and  CloseAll  are  called  when  event  generating  operations  are  performed  by  the  user. 

In  addition  to  the  TAE  Plus  code  generated  files,  TAE  Plus  provides  two  basic  sets  of 
library  functions  for  applications  programmers:  the  Windows  Programming  Tools  package 
(Wpt)  and  the  Variable  Manipulation  (Vm)  package. 

The  Wpt  package  contains  C  functions  that  provide  programs  with  graphic,  window- 
based  user  interfaces.  The  purpose  of  these  functions  is  to  deliver  user  inputs  to  an 
application  program.  Based  on  information  provided  in  the  resource  file,  Wpt  determines 
the  desired  form  of  user  interaction  and  creates  the  appropriate  displays  on  the  screen. 
When  the  user  enters  or  selects  values  for  the  program  inputs,  Wpt  functions  make  the 
values  or  selection  available  to  the  program. 

The  Vm  package  consists  of  standard  TAE  data  structures  called  Vm  objects.  When 
an  application  program  begins,  it  reads  the  panel  and  item  information  contained  in  the 
resource  file  into  these  Vm  objects.  Wpt  uses  two  Vm  objects  to  acquire  each  set  of  inputs. 
The  “target”  Vm  object  describes  the  inputs  to  be  acquired.  The  “view”  object  describes  the 
presentation  of  the  target  parameters  on  the  screen.  After  the  user  interface  information  is 
read  into  the  Vm  objects,  the  program  passes  pointers  to  the  objects  as  arguments  to  Wpt 
functions. 

The  generation  of  C+-»-  files  is  similar  to  that  of  the  C  files.  Table  2  provides  a  sample 
of  the  files  produced  by  TAE  Plus  in  C++.  These  files  are  found  in  Appendix  C. 
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Regardless  of  the  programming  language  used,  the  following  figures  are  the  initial 
panels  for  each  of  the  three  program  modules  Set  Up,  Events,  and  Overview.  For  a  more 
complete  presentation  of  the  graphical  user  interface,  see  Appendix  A. 

Table  2:  SAMPLE  OF  BGLCSS  2.0  SETUP  C++  GENERATED  HUES 


File 

Description 

BGSetup . cc 

Contains  main  procedure. 

BGSetup  .h 

Encapsulates  the  resource  hie. 

BGSetup_init_pan . cc 

Initializes  all  panels. 

BGSetup_creat_init . 

cc 

Creates  the  initial  panel  set. 

pan_BGSetupBGs . h 

Contains  the  panel’s  class  dehnition  and  instance  parameter  declara¬ 
tions. 

pan_BGSetupBGs . cc 

Contains  the  panel’s  class  methods. 

itein_BGSetupBGs  .h 

Class  dehnitions  of  all  items  in  the  panel  and  instance  parameters 
declarations. 

Imakef ile 

Machine-independent  template  for  generating  the  Makehle  for  the 
application. 
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IV.  BGLCSS  2.0  STRUCTURED  DESIGN 


A.  GENERAL 

This  chapter  describes  the  design  decisions  and  implementation  issues  of  BGLCSS 
2.0  using  a  structured  programming  paradigm.  The  following  chapter  will  discuss  the 
design  decisions  and  implementation  issues  of  a  part  of  BGLCSS  2.0  using  an  object- 
oriented  programming  paradigm. 

BGLCSS  1.0  was  written  in  Turbo  Pascal  to  run  in  a  DOS  operating  system  on  an 
IBM  PC- AT  compatible  microcomputer  [SCHRADY  91].  According  to  the  proposal  for 
research  statement  of  work, ’’Moving  BGLCSS  into  JOTS  involves  much  more  than  code 
conversion.  The  JOTS  II  environment  includes  communications  interfaces  and  a  variety  of 
services  which  must  be  utilized  to  reduce  the  labor  intensiveness  of  the  current  version  of 
BGLCSS.  The  data,  planning  factors,  and  algorithms  in  the  current  version  of  BGLCSS 
will  carry-over,  but  the  program  must  be  completely  restmctured.” 

In  other  words,  by  moving  BGLCSS  1.0  into  the  JOTS  II  environment,  the  program 
would  require  restructuring  solely  in  order  to  take  advantage  of  the  variety  of  JOTS  II 
services  and  to  reduce  user  data  entry  activity.  Among  other  things,  it  was  assumed  that  the 
algorithms  would  carry  over.  In  fact,  however,  after  extensive  examination  of  the  original 
Pascal  code,  this  was  found  not  to  be  the  case. 

The  algorithms  in  question,  as  far  as  the  code  is  concerned,  represent  the  battle  groups, 
ships,  and  events.  It  was  thought  that  the  original  logic  of  the  program,  could  be  easily 
translated  to  another  programming  language,  a  new  interface  attached,  and  JOTS  services 
incorporated.  It  was  not  feasible  to  translate  or  carry  over  any  of  the  original  Pascal  code 
for  three  reasons. 

First,  the  original  program  was  developed  in  a  rapid,  iterative,  and  ad  hoc  manner  and 
the  Pascal  code  is  a  classic  example  of  one  of  the  weaknesses  of  developing  software 
without  a  high-level  design.  The  code  was  largely  undocumented  and  no  high-level 
descriptions  of  algorithms,  function  definition.s,  nor  variable  definitions  were  provided. 
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Without  any  of  this  program  documentation,  the  original  BGLCSS  code  was  virtually 
untranslatable  to  C. 

Second,  the  data  structures  used  to  represent  the  simulated  events  were  ill-suited  for 
simulation  purposes  and  introduced  unnecessary  inefficiencies  and  redundancies  into  the 
program. 

Finally,  the  organization  and  layout  of  the  user  interface  was  complicated  and  difficult 
to  use.  For  these  reasons,  BGLCSS  2.0  was  completely  restructured  to  take  advantage  of 
the  variety  of  JOTS  II  services  and,  furthermore,  to  redesign  and  redevelop  the  algorithms, 
data  structures,  and  user  interface. 

The  following  sections  present  the  structured  design  and  implementation  of  BGLCSS 
2.0.  The  components  of  the  design  are:  the  program  specifications;  symbolic  constants; 
data  structures  for  battle  groups,  ships,  and  events;  library  design  of  battle  group,  ship,  and 
event  functions;  graphical  user  interface  design;  and  application  integration  issues. 

B.  PROGRAM  SPECIFICATIONS 

The  goal  was  to  produce  a  program  that  simulates  the  occurrence  of  a  number  of 
logistics  events  and  calculates  the  usage  of  fuels  and  ordnance  based  on  specific  planning 
factors.  Program  specifications  were  abstracted  from  the  user’s  manual  for  BGLCSS  1.0 
[SCHRADY91]. 

C.  SYMBOLIC  CONSTANTS 

In  BGLCSS  I.O,  symbolic  constants  were  scattered  throughout  the  multiple  file 
program.  Consequently,  this  added  an  unnecessary  layer  of  confusion  when  trying  to 
understand  where  the  constants  were  defined.  As  a  result,  all  of  the  symbolic  constants  in 
BGLCSS  2.0  are  contained  in  one  file,  bg.h.  shown  in  Figure  1 9.  The  preprocessor  directive 
#def  ine  gives  names  to  constants,  also  known  as  literals.  By  using  these  literals,  a 
change  can  be  easily  made  in  one  place  and  take  effect  throughout  the  program 
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#def ine 

MAXNAME 

25 

#def ine 

MAXF76COEF 

3 

#def ine 

MAXSHIPTYPES 

8 

#def ine 

MAXORD 

100 

#def ine 

MAXRATES 

6 

#def ine 

MAXACFT 

20 

#def ine 

MAXTHREATLEVELS 

2  /*  Low,  Medium,  High  */ 

#def ine 

MAXENGAGEMENTS 

2  /*  Raid,  Strike,  ASW  */ 

#def ine 

MAXINTERVALS 

3 

#def ine 

HOURS INDAY 

23 

#def ine 

MAXUSETYPES 

5 

#def ine 

MAXBGSHIPS 

30 

#def ine 

MAXBGS 

10 

#def ine 

MAXORD 

100 

#def ine 

MAXSHIPS 

100 

#def ine 

DTGLENGTH 

15 

#def ine 

MAXLENGTH 

25 

#def ine 

F76DATA 

" /h/bg less /scripts /data /F7 6 .dat" 

#def ine 

BGDATA 

" /h/bglcss/scripts/data/BGData .dat" 

#def ine 

BGSHIPS 

" /h/bglcss/scripts/data/Ships" 

#def ine 

NAVYSHIPS 

" /h/bg less /scripts /da ta/NavyShips . dat " 

#def ine 

EVENTS DATA 

" /h/bglcss/scripts/data/Events " 

#def ine 

HEADERSDATA 

" /h/bg less /scripts /dat a /Headers" 

Figure  19:  Symbolic  Constants  for  Battle  Groups  and  Ships 
D.  DATA  STRUCTURES 

There  are  two  different  kinds  of  data  used  in  this  program:  battle  group  data  and  event 

data. 


1.  Battle  Groups 

Battle  groups  are  represented  by  an  array  of  battle  group  records  or  structs.  Each 
battle  group  is  a  struct  containing  a  name,  a  designation,  a  structure  containing  settings 
information,  a  structure  containing  location  information,  an  array  of  ship  structures,  and  an 
array  of  capacity  information  structures  as  shown  in  Figure  20.  The  battle  groups  are 
represented  by  arrays  of  structures.  The  most  frequent  activities  associated  with  the  battle 
groups  involve  data  access,  i.e.  reading  or  writing  data.  Insertions  and  deletions  of 
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structures  to  the  battle  group  are  performed  without  regard  to  the  order  of  structures  within 
an  array.  Access  to  structures  of  an  array  is  performed  easily  using  an  index  to  an  array. 


Figure  20:  Battle  Group  Data  Structures 

Figure  21  shows  the  C  code  that  defines  the  battle  group  data  struct.  This 
definition  is  found  in  the  bg .  h  file  contained  in  Appendix  B. 


typedef  struct  ( 

char 

Name [MAXNAME] ; 

char 

Designation [MAXNAME] ; 

Settingsinfo 

Settings; 

Locationinfo 

Location ; 

Shiplnfo 

Ships [MAXBGSHIPS]  ; 

Capacityinfo 

}BGInfo; 

Results [MAXBGSHI PS]  ; 

Figure  21 ;  Battle  Group  information  Type  Definition 
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The  first  four  variables  contained  in  the  settings  struct  shown  in  Figure  22  are 
“trip-wire”  reserve  levels  that  are  set  by  the  user  so  that  when  reserve  levels  fall  below  these 
levels,  the  user  is  notified.  FuelRes  represents  F-76  fuel  reserve  level,  CLFFuelRes 
represents  CLF  fuel  reserve  levels,  OrdRes  represents  ordnance  reserve  levels,  and 
CLFOrdRes  represents  CLF  ordnance  reser\'c  levels.  MaxF76  and  MaxF44  each 
represents  the  maximum  fuel  capacities  for  F-76  and  F-44  fuels  respectively.  StationSpeed 
represents  battle  group  ship  stationing  speed,  UnrepSpeed  represents  underway 
replenishment  battle  group  ship  speed,  and  AeftShipSpeed  represents  battle  group  aircraft 
carrier  ship  speed.  Each  of  these  variables  are  represented  by  a  floating  point  type. 

PredictStart  is  used  to  represent  the  integer  value  of  the  date  time  group  supplied 
by  the  user.  This  variable  represents  the  first  time  interval  for  which  commodity  percent 
capacities  are  to  be  computed.  The  following  array  of  integers,  PredictHours,  is  used  to 
hold  the  number  of  hours  to  offset  each  of  the  three  intervals  of  time  for  which  commoditiy 
percent  capacities  are  to  be  computed. 


typedef  struct  (  I 

float 

FuelRes, 

CLFFuelRes, 

OrdRes, 

CLFOrdRes , 

MaxF76, 

MaxF44 , 

StationSpeed, 

UnrepSpeed, 

AeftShipSpeed; 

int 

PredictStart ; 

int 

PredictHours [MAXINTERVALS] ; 

} Set tings Info; 

Figure  22:  Settings  Information  Type  Definition 

The  location  information  struct  is  used  to  hold  the  current  battle  group  location 
information  as  shown  in  Figure  23.  This  same  struct  definition  is  also  used  within  the  ship 
struct. 
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typedef  struct  { 
int  Dtg; 
float  Speed, 

MaxSpeed; 
double  Latitude, 
Longitude, 
Course; 

) Locationinfo; 


Figure  23:  Location  Information  Type  Definition 

Capacity  information  contains  three  arrays  as  shown  in  Figure  24.  The 
F76Capacity  and  F44Capacity  arrays  are  designed  to  each  contain  MAXINTERVALS 
floating  point  values,  one  for  each  time  interval. 


typedef  struct! 

float  F76Capacity [MAXINTERVALS] , 

F44Capacity [MAXINTERVALS] ; 
OrdCapInfo  OrdCapacity [MAXINTERVALS] ; 
}CapacityInfo; 


Figure  24:  Capacity  Information  Type  Definition 


2.  Ships 

The  ship  struct  shown  in  Figure  25  contains  string  variables  (in  C,  strings  are 
represented  as  arrays  of  chararacters)  for  the  name  and  hull  number  of  the  ship.  The  Type 
Combatant  is  represented  as  an  enumerated  type  having  one  of  the  following  values:  Air, 
Combatant,  Station,  and  Shuttle. 

Identical  to  the  battle  group  struct,  the  ship  struct  also  contains  a  location  struct  as 
shown  in  Figure  26  . 
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typedef  struct  { 
char 

Name[MAXNAME] ; 

char 

HullIMAXNAME] ; 

CLFType 

TypeCombatant ; 

Locationinfo 

Location; 

F76Info 

F76; 

F44Info 

F44; 

int 

Approach, 

Ordinfo 

BreakAway ; 
OrdfMAXORD] ; 

Acf tinfo 

Acf t [MAXACFT] ; 

}ShipInfo; 

Figure  25:  Ship  Information  Type  Definition 


typedet  struct  I 
int  Dtg; 
float  Speed, 

MaxSpeed ; 
double  Latitude, 
Longitude, 
Course; 

) Location Info; 


Figure  26:  Location  Information  Type  Definition 

The  next  variable  is  a  struct,  containing  data  specific  to  the  F-76  state  as  shown 
in  Figure  27.  The  first  seven  variables  are  integers  used  to  represent  the  ship  capacity  in 
gallons,  the  receive  rate  in  gallons  per  minute,  the  transfer  rate  in  gallons  per  minute,  the 
current  number  of  gallons  on  hand,  the  most  recent  estimated  number  of  gallons  on  hand, 
the  integer  value  of  the  date  time  group  of  the  on  hand  reading,  and  the  date  time  group  of 
the  estimated  on  hand  value.  The  last  variable  is  an  array  of  coefficients  used  in  predicting 
fuel  consumption  [SCHRADY  90]. 
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typedef  struct  { 

int 

Capacity, 

ReceiveRate, 

Transf erRate, 

OnHand, 

EstOnHand, 

OnHandDtg, 

EstOnHanDi'g; 

float 

Coef [MAXF76COEF] ; 

}F76Info; 

Figure  27;  F-76  Ship  Fuel  Information  Type  Definition 

The  struct  shown  in  Figure  28  contains  data  specific  to  the  F-44  aircraft  fuel  state 
and  is  almost  a  mirror  image  of  the  previous  F-76  struct  mentioned  above  except  that  the 
F-44  struct  does  not  contain  a  coefficients  array. 


typedef  struct  { 
int  Capacity, 

ReceiveRate, 

TransferRate, 

OnHand, 

EstOnHand, 

OnHandDtg, 

EstOnHandDtg ; 

}F44Info; 


Figure  28:  F-44  Aircraft  Fuel  Information  Type  Definition 

An  array  of  Ordinfo  structs,  as  shown  in  Figure  29,  is  contained  in  the  ship  struct. 
Each  Ordinfo  struct  represents  data  specific  to  one  ordnance  item.  The  variables  contained 
in  this  struct  are  similar  to  the  previous  two  fuel  .structs  except  that  the  Ordinfo  struct 
contains  an  array  of  use  rates.  MAXRATES  refers  to  the  six  different  use  rates:  low, 
medium,  or  high  average  threat  levels,  and  raid,  strike,  or  ASW  events. 
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typedef  struct  { 

OrdName 

Name[MAXNAME] ; 

int 

TotalNumber, 

9 

Capacity, 

Range , 

Transf erRate, 

OnHand, 

EstOnHand, 

OnHandDtg, 

EstOnHandDtg; 

OrdUse 

)OrdInfo; 

UseRate[MAXRATESl ; 

Figure  29:  Ordnance  Information  Type  Definition 


3.  Events 

A  doubly  linked  list  is  a  data  structure  consisting  of  structs  connected  to  each 
other  by  pointers  to  the  next  and  to  the  previous  struct,  as  shown  in  Figure  30  . 


Figure  30:  Battle  Group  Event  List 


The  decision  to  use  such  a  data  structure  was  based  on  the  intended  use  of  battle 
group  event  information.  Since  the  purpose  of  BGLCSS  is  to  dynamically  simulate  events 
in  time,  the  easy  insertion,  sorting,  and  deletion  of  events  is  the  dominant  criteria  for 
selecting  the  appropriate  data  structure.  A  doubly  linked  list  fulfills  this  criteria.  It  allows 
easy  movement  forward  and  backward  between  list  element  structures,  sorted  insertions 
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and  deletions  are  easily  performed  by  manipulating  pointers.  The  pointers  on  the  ends  of 
the  list  both  point  to  null. 


There  are  three  different  doubly  linked  list  data  structures  used  to  implement  the 
battle  group  events:  the  battle  group  event  list  itself,  the  related  event  list,  and  the  header 
list.  The  battle  group  event  list  is  represented  by  battle  group  event  information  structs  in 
a  doubly  linked  list.  The  code  used  to  define  a  BGEvent  is  shown  in  Figure  31  . 


struct  BGEvent  T 


struct  BGEvent 

*Prev, 

*Next  ; 

int 

Dtg, 

CreateTime , 
Predictinterval , 

BGEventType 

EType ; 

PredictType 

PType ; 

CalcType 

CType; 

ThreatType 

TType ; 

Unrepinfo 

Unrep; 

Directioninfo 

Direction; 

Strikeinfo 

Strike ; 

Raidinfo 

Raid; 

ASWInf o 

ASW; 

); 

typedef  struct  BGEvent  BGEVENT; 


Figure  3 1 ;  Battle  Group  Event  Type  Definition 

The  first  two  variables  are  the  pointers  to  the  previous  and  to  the  next  BGEvent 
structs.  The  Dtg  variable  is  the  integer  representation  of  date  time  group  for  the  start  of  the 
battle  group  event.  The  next  integer  variable  is  the  system  time  stamp  of  the  event’s 
creation  time.  This  is  a  unique  time  stamp  for  each  event  in  the  event  list.  The  next  four 
variables  are  used  when  evaluating  each  event  in  the  list.  EType  is  used  to  identify  the  type 
of  event,  i.e.  battle  group  course  and  speed,  AAW  threat  level,  etc.  PType  is  used  to  identify 
whether  the  BGEvent  PredictType  is  an  orphan,  child,  parent,  or  interval.  The  first  three 
values  will  be  discussed  in  the  next  section.  The  interval  value  refers  to  a  BGEvent  which 
is  actually  a  sentinel  marking  the  time  interval  for  calculation  purposes.  Unrep  is  a  struct 
containing  data  relevant  to  an  underway  replenishment  event.  Directioninfo  contains  data 
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about  the  course  and  speed  of  the  ship  involved.  The  last  three  structs  contain  information 
specific  to  the  strike,  raid,  and  ASW  events. 

One  of  the  most  significant  omissions  in  BGLCSS  1.0  was  the  way  that  an 
underway  replenishment  event  and  its  associated  stationing  events  were  handled  in  the 
event  list.  When  a  user  added  an  underway  replenishment  event,  depending  on  the  tactic 
used,  several  stationing  events  were  also  added  to  the  list.  If  a  user  wanted  to  delete  the 
underway  replenishment,  it  was  necessary  for  the  user  to  know  which  stationing  events  to 
delete  as  well.  This  problem  was  corrected  by  using  an  additional  doubly  linked  list  for 
related  events  as  shown  in  Figure  32. 


Figure  32:  Battle  Group  Related  Event  and  Battle  Group  Event  List 

When  an  underw'ay  replenishment  or  a  consol  event  is  created,  a  relation  event, 
shown  in  Figure  33,  is  also  created  and  inserted  into  a  doubly  linked  list.  The  relation  struct 
is  created  based  on  the  system  creation  time  stamp  of  the  underway  replenishment  event, 
also  known  as  a  parent  event.  Each  event  associated  with  the  underway  replenishment 
parent  event  also  contains  the  same  creation  time.  The  relation  event  pointers  point  to  all  of 
the  child  events,  i.e.  stationing  events,  in  the  BGEvent  list.  When  the  deletion  of  a 
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underway  replenishment  is  to  be  performed,  the  related  relation  event  is  found  and  all  of 
the  BGEvents  to  which  it  points  are  deleted  along  with  itself.  An  orphan  is  an  event  that  is 
not  related  to  any  other  event,  such  as  a  battle  group  course  and  speed  or  a  ship  stationing 
event. 


struct  ReiationType  { 

struct  Relat ionType 

*Prev, 

int 

*r;ext  ; 

CreateTime ; 

BGEVENT 

‘Childl, 

}  ; 

typedef  struct  ReiationType 

*Child2, 

*Child3, 

*Child4, 

*Child5; 

RELATION; 

Figure  33:  Relation  Type  Definition 

The  last  doubly  linked  list  contains  the  components  of  a  string  to  represent  an 
event  to  the  user  in  English  (see  Figure  34). 


Figure  34;  Battle  Group  Header  List 


It  is  used  as  a  convenient  way  to  show  the  string  representation  of  the  event  list. 
For  example,  the  event  list  is  displayed  to  the  user  as  shown  in  Figure  35.  This  list  is  made 
up  of  structs  containing  the  string  equivalent  of  the  BGEvent  list.  It  is  used  instead  of 
traversing  the  BGEvent  list  and  generating  string  equivalents  for  each  event  each  time  that 
the  event  list  would  be  displayed  on  a  panel. 
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Figure  35;  BGLCSS  2.0  Event  List  Panel 

Figure  36  shows  the  BGHeader  Type  definition  for  the  header  structs  in  the 
header  list. 


Struct  BGHeader ( 

struct  BGHeader 

*Prev, 

*Next ; 

BGEventType 

EType ; 

int 

Index; 

int 

DTG; 

char 

Date [DTGLENGTH] ; 

char 

Title [MAXLENGTH] ; 

f  loat 

Course ; 

f  loat 

)  ; 

Speed; 

trypedef  struct  BGHeader 

BGHEADER ; 

Figure  36:  Battle  Group  Header  Type  Definition 


E.  BGLCSS  2.0  LIBRARY  DESIGN 


The  application  library  design  refers  to  the  functions  written  to  operate  on  the  data 
structures  in  the  BGLCSS  application.  There  are  three  groups  of  functions  based  on  the 
kind  of  data  involved:  battle  groups,  ships,  and  events. 

Table  3  shows  the  function  name  and  purpose  for  each  function  that  operates  on  battle 
groups.  These  functions  are  contained  in  bg  .  c  in  Appendix  B. 


Table  3:  BATTLE  GROUP  FUNCTIONS 


Function 

Purpose 

CancelBG 

Clears  out  data  from  the  text  keyin  items  on  BG  panels  BGData  and  New  BG 
panels. 

DeleteBG 

Deletes  a  battle  group  from  the  array  by  replacing  its  name  with  blank  spaces. 

GetBG 

Using  the  string  representation  of  the  name  of  a  battle  group  and  the  index  to 
the  appropriate  battle  group  in  the  array,  return  the  index  to  the  battle  group. 

GetBGs 

Given  the  battle  group  array,  this  function  gets  the  battle  group  data  from  the 
battle  group  data  ASCII  text  file.  Returns  the  next  available  battle  group  in¬ 
dex.  Given  the  battle  group  array,  this  function  gets  the  battle  group  data 

GetShip 

Using  the  string  of  a  ship  name  and  the  index  to  the  appropriate  banle  group, 
this  function  returns  the  ship  index  fcx*  the  appropriate  ship. 

MakeBG 

Makes  a  new  battle  group,  using  information  provided  by  user  to  New  BG 
panel.  The  index  for  the  next  available  battle  group  in  the  array  is  returned. 

SaveBGs 

Saves  all  battle  groups  to  the  ASCII  text  file  containing  BG  data 

SaveNewBG 

Saves  the  new  battle  group  using  the  TAE  Vm  target  object  from  the  user  in¬ 
put  panel.  First.  GetBGs  is  called,  returning  the  available  index  to  the  array. 
Next.  Make  BG  is  called  and  then  SaveBGS  saves  all  battle  groups. 

ShowBG 

Shows  the  battle  group's  data  given  battle  group  array,  index  and  panel  name. 

ShowBGs 

Shows  the  list  of  battle  groups  from  an  ASCII  text  file  to  an  item  in  a  panel. 

Table  4  shows  the  function  name  and  purpose  for  each  function  that  operates  on  ships. 
These  functions  are  also  contained  in  bg.c  in  Appendix  B. 


46 


Table  4:  SHIP  FUNCTIONS 


Function 

Purpose 

AddShip 

This  function  adds  a  ship  and  its  data  to  a  battle  group.  The  ship  list 
presented  to  the  user  contains  both  the  hull  number  and  the  ship 
name.  The  hull  number  is  required  to  get  the  ship  type  for  the  appro¬ 
priate  F76  information.  The  ship  name  is  returned. 

ConvertT  ypeCombatant 

Converts  an  integer  to  the  appropriate  string  representation  of  Type- 
Combatant.  C  stores  the  value  of  an  enumerated  type  on  an  ASCII 
file  as  an  integer.  To  display  this  value  in  a  panel,  it  must  be  convert¬ 
ed  to  a  string. 

GetF76Table 

Gets  the  F76  information  by  ship  type  from  the  ASCII  text  file  into 
memory. 

GetShip 

Using  the  string  of  a  ship  name  and  the  index  to  the  appropriate  bat¬ 
tle  group.  GetShip  returns  the  ship  index  for  the  appropriate  ship. 

SaveBGShips 

Using  the  BG  array  and  the  index  to  the  specific  battle  group,  this 
function  saves  the  battle  group’s  ships'  data  to  an  ASCII  text  file. 

ShowBGShips 

Shows  the  list  of  battle  group  ships,  given  battle  group  index,  panel 
name,  and  selection  list  item  on  panel. 

ShowF76 

UsesTAE  Wpt  and  Vm  functions  to  display  values  to  the  Ship  panel. 

ShowNavyShips 

Shows  the  list  of  navy  ships  from  ASCII  text  file  to  item  in  panel. 

ShowShip 

UsesTAE  Wpt  and  Vm  functions  to  display  values  to  the  Ship  panel. 

TypeShip 

Checks  the  first  two  characters  in  a  ship’s  hull  number  and  returns 
an  integer  that  equates  to  an  enumerated  ship  type. 

Table  5  shows  the  function  name  and  purpose  for  each  function  that  operates  on  the 
three  doubly  linked  lists  involved  with  BGLCSS  events.  These  functions  are  contained  in 
BGEventsLib .  c  in  Appendix  B. 
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Table  5:  BATTLE  GROUP  EVENT  FUNCTIONS 


Function 

Purpose 

DeleteBGEvent 

Given  a  pointer  to  the  head  of  the  battle  group  event  list  and  the  event  to  be 
deleted,  this  function  deletes  the  event.  Before  calling  this  function  with  the 
Parent  Event  node  pointer,  need  to  call  the  DeleteChildren  function  to  delete 
the  associated  children. 

DeleteChildren 

This  function  makes  repeated  calls  to  DeleteBGEvent  in  order  to  delete  all 
of  the  children  of  the  Parent  event.  Returns  the  head  of  the  battle  group  event 
list. 

GetBGEvents 

This  function  reads  the  battle  group  event  list  data  from  the  appropriate 
ASCII  text  file  given  the  index  to  the  battle  group  array.  It  returns  a  pointer 
to  the  head  of  the  battle  group  event  list. 

GetParent 

This  functions  finds  the  Parent  event  with  its  unique  time  stamp.  If  the  par¬ 
ent  doesn’t  exist,  then  it  finds  the  orphan  event  and  returns  a  pointer  to  the 
event  found. 

GetRelation 

This  functions  finds  the  Parent  event  with  its  unique  time  stamp.  If  the  par¬ 
ent  doesn’t  exist,  then  it  finds  the  orphan  event  and  returns  a  pointer  to  the 
event  found. 

InsertBGEvent 

This  function  takes  a  pointer  to  the  head  of  the  battle  group  event  list  and 
a  pointer  to  the  newly  created  battle  group  event  and  inserts  the  new  event 
into  the  list  based  on  chronological  date  time  group  of  the  events.  Returns 
a  pointer  to  the  head  of  the  battle  group  event  list. 

InserlRelation 

This  function’s  basic  algorithm  is  virtually  the  same  to  InsertBGEvent  ex¬ 
cept  for  the  final  if-statement  assignments  and  the  data  type  involved. 

MakeBGEvent 

Given  the  information  from  an  event  panel,  this  function  makes  a  battle 
event  node  and  returns  a  pomter  to  it.  This  function  is  currently  designed  to 
handle  only  a  battle  group  course  and  speed  change  event. 

MakeChild 

This  function  makes  a  child  event  by  first  calling  MakeBGEvent  and  attach¬ 
ing  the  child  to  the  appropriate  relation  node.  After  a  call  to  this  function 
is  made,  need  to  call,  for  instance,  UnrepCalculations  and  make  the  appro¬ 
priate  assignments  to  the  event  node.  Function  returns  a  pointer  to  the  newly 
made  child. 

MakeRcIation 

This  functions  makes  a  related-event  node  used  to  connect  related  events  to¬ 
gether  such  as  an  unrep  with  its  associated  stationing  events.  The  parameter 
passed  is  the  integer  value  of  the  creation  time  for  the  parent  event  (such  as 
the  unrep  event).  No  more  than  5  associated  events  are  allowed  by  this  func¬ 
tion.  Returns  a  pointer  to  the  newly  created  relation  node. 
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Table  5;  BATTLE  GROUP  EVENT  FUNCTIONS 


Function 

Purpose 

MakeUnrep 

Given  a  pointer  to  the  newly  made  event  node  and  the  values  passed  from 
the  Unrep  panel,  return  a  completed  unrep  event  node  to  be  added  to  the 
event  list. 

SaveBGEvents 

This  function  saves  the  battle  group  events  list  given  an  index  to  the  ^pro- 
priaie  battle  group  in  the  array  and  a  pointer  to  the  head  of  the  battle  group 
event  list.  It  returns  the  pointer  to  the  head  of  the  list. 

MakeBGHeader 

This  function  creates  the  header  to  be  displayed  in  the  event  list  panel  to  the 
user.  Given  the  event  parameters,  return  a  header  node. 

GetBGHeaders 

Given  the  appropriate  index  to  the  battle  group  array,  this  function  gets  the 
battle  group  header  information  from  the  appropriate  ASCII  text  file  and  re¬ 
turns  a  pointer  to  the  head  of  the  battle  group  header  list.  Similar  in  algo¬ 
rithm  to  GetBGE  vents. 

InsertBGHeader 

This  function  inserts  the  newly  created  BGHeader  into  the  Header  list  given 
a  pointer  to  the  head  of  the  header  list  and  a  pointer  to  the  newly  created 
BGHeader.  It  returns  a  pointer  to  the  head  of  the  header  list. 

SaveBGHeaders 

Given  an  index  to  the  battle  group  array  and  a  pointer  to  the  head  of  the 
battle  group  header  list,  this  function  saves  the  header  list  data  to  the  appro¬ 
priate  ASCII  text  file.  Returns  a  pointer  to  the  head  of  the  header  list. 

F.  PROGRAM  INTEGRATION 

There  are  two  ways  to  connect  a  call  to  an  application  library  function  to  the  interface 
code.  If  there  is  only  one  line  of  code,  i.e.  a  call  to  a  single  function,  this  line  of  code  can 
be  inserted  at  the  WorkBench  level  using  the  Connection  Specification  Panel  shown  in  the 
previous  chapter.  This  is  the  best  method,  because  if  an  item  on  a  panel  is  changed  from  an 
event-generating  item  to  a  non-event-generating  item,  the  source  code  is  overwritten.  The 
original  file  is  copied  to  a  backup  file  with  a .  bak  suffix.  However,  if  several  calls  need 
to  be  made  to  handle  a  given  TAE  event,  then  the  insertion  must  be  made  by  hand  by  the 
applications  programmer.  To  maximize  integration  at  the  WorkBench  level,  once  a 
sequence  of  application  function  calls  within  a  TAE  Plus  event  handler  function  are 
debugged,  a  higher-level  application  function  can  be  written  to  make  the  sequence  of 
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function  calls  itself.  Thus,  a  higher-level  function  call  can  be  integrated  at  the  WorkBench 
level. 

The  TAE  Plus  documentation  suggests  that  a  symbol  be  used  for  each  alteration  to 
TAE  Plus  generated  source  code  so  that  in  the  event  of  code  regeneration,  a  relatively  easy 
cut  and  paste  operation  can  be  performed.  The  /*BERN*/  symbol  was  used  in  this 
application. 

TAE  Plus  uses  an  Imakef  ile  to  create  an  application  specific  Makefile  which 
then  correctly  compiles  and  links  object  files  with  the  appropriate  libraries.  The 
Imakef  ile  can  be  edited  to  include  the  application  library  code  for  compilation.  In  this 
case,  the  APP  flags  in  the  Imakef  ile  for  the  BGSetup  module  to  be  bg.  c.  See  the 
Imakef  ile  in  Appendix  B. 

Each  panel  file  must  include  the  pan_name.h  files  for  associated  panels  as  well  as 
connected  panels.  Connected  panels  are  already  handled  by  the  TAE  code  generator. 
Associations  that  fall  outside  of  the  WorkBench  domain  must  be  done  by  hand.  A  panel 
may  be  associated  with  another  if,  for  instance,  data  from  one  panel  is  required  to  perform 
operations  initiated  by  another  panel.  Although  TAE  automatically  will  insert  a  #include 
pan_*  ,  h  for  connected  panels,  the  application  writer  must  still  explicitly  include  header 
files  for  panels  requiring  information  from  a  previous  panel. 

Any  application  functions  used  in  the  pan_*  .  c  files  must  be  declared  as  external 
ahead  of  the  event  handling  function  definition  for  the  particular  panel. 

G.  STRUCTURED  DESIGN  PROBLEMS 

Despite  the  top-down  functional  decomposition  approach  to  this  application,  there  are 
several  problems  with  this  design.  The  separation  of  the  code  and  the  data  is  evident  in  the 
separation  of  the  struct  and  type  definitions  in  bg  .  h  and  BGEventsLib .  h  and  the 
function  libraries  in  bg  .  c  and  BGEventsLib .  c.  At  any  point  in  the  main  program,  a 
variable  such  as  a  BGInfo  array  could  be  declared  and  filled  with  bad  data  and  then  saved 
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to  the  ASCn  text  file.  This  vulnerability  of  the  battle  group  data  is  a  clear  weakness  of  this 
design. 

Second,  while  this  application  does  define  numerous  user-defined  types  such  as  the 
enumerated  types  and  stnicts,  these  definitions  amount  only  to  labels  that  improve  program 
clarity.  They  do  not  prevent  illogical  operations  from  being  performed  such  as  assigning 
bad  values  to  the  enumerated  types.  Furthermore,  as  previously  mentioned,  date  time 
groups  and  latitudes  and  longitudes  are  reduced  to  built-in  data  types  and  poorly  represent 
real  world  entities.  This  data  type  deficiency  led  to  the  GOTS  library’s  long  list  of 
specialized  functions  as  well  as  to  the  redundant  BGLCSS  library  functions  such  as  the 
InsertBGEvent,  In sertBG Header,  etc. 

Third,  the  distributed  functionality  of  this  design  will  make  subsequent  program 
modifications  and  extensions  difficult.  For  instance,  to  add  another  logistics  event  type 
would  require  changes  to  be  made  to  every  event-related  function  that  contained  a  case 
statement  specific  to  event  type. 
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V.  BGLCSS  2.0  OBJECT-ORIENTED  DESIGN 

A.  CLASSES 

This  chapter  provides  a  high-level  view  of  how  BGLCSS  2.0  could  be  designed  using 
an  object-oriented  paradigm  in  C-»-+.  We  intend  to  provide  examples  of  how  the  use  of  an 
object-oriented  paradigm,  when  correctly  applied,  leads  to  code  reuse,  ease  of  program 
maintenance  and  extension.  Since  the  arguments  presented  here  are  not  dependent  on  low- 
level  definition  details,  most  class  member  functions  are  presented  only  as  prototypes. 

Object-oriented  design  is  based  on  classes  and  one  useful  approach  to  object-oriented 
design  consists  of  the  following  methodology  [COPLIEN  92]; 

(1)  Identify  the  entities  in  the  application  domain. 

(2)  Identify  the  behaviors  of  the  entities. 

(3)  Identify  the  relationships  between  entities. 

(4)  Create  a  C++  design  structure  from  the  entities. 

According  to  step  (1),  the  entities  in  the  application  domain  are  battle  groups,  ships, 
and  logistics  events.  Step  (2),  the  identification  of  the  behaviors  of  the  entities  is  listed  in 
Table  6.  The  behaviors  of  the  battle  group  entity  are  limited  to  getting,  setting,  adding,  and 
deleting  subcomponents.  The  ship  entity,  in  addition  to  these  behaviors,  consumes  and  fUls 
up  with  F-76,  F-44,  and  ordnance  commodities.  Events,  shown  as  a  high-level  abstraction 
of  all  twelve  events,  includes  a  computation  behavior  called  F^rocessEvents  which  performs 
calculations  of  the  F-76,  F-44,  and  ordnance  states  of  ships  in  a  battle  group. 
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Table  6:  SAMPLE  BEHAVIORS  OF  BGLCSS  ENTITIES 


Battle  Groups 

Ships 

Events 

GetBGName 

GetShipName 

GetEventList 

GetBGIndex 

GetShipIndex 

SaveEventList 

GetBG 

GetShipData 

AddEvent 

SaveBG 

SetShipData 

DeleteEvent 

GetBGShips 

GetShipLocation 

GetEvent 

SaveBGShips 

SetShipLocation 

ProcessEvents 

AddBGShip 

GetShipF76 

DeleteBGShip 

SetShipF76 

GetBGLocation 

GetShipF44 

SetBGLocation 

SetShipF44 

GetBGResults 

GetShipOrdnance 

SetBGResults 

SetShipOrdnance 

GetShipAcft 

SetShipAcft 

ConsunieF76 

ConsumeF44 

ConsumeOrdnance 

FillF76 

FillF44 

FillOrdnance 

Step  (3),  identifying  the  relationships  between  entities,  is  probably  the  most  crucial 
step  of  the  design  process.  First,  the  battle  group  exhibits  a  has  a  relationship  with  its  ships, 
settings,  location,  and  results.  This  relationship  can  be  modeled  with 
composition.Therefore,  an  array  of  Shipinfo  class  objects,  a  Settingsinfo  class  object,  a 
Location  Info  class  object,  and  an  array  of  Capacityinfo  class  objects  can  be  contained 
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within  a  BGlnfo  class  object.  Second,  the  Shipinfo  class  can  be  modeled  based  on  an  is  a 
relationship  with  all  of  the  special  cases  of  a  ship:  destroyer,  frigate,  aircraft  carrier,  etc. 
Finally,  events,  at  this  level  of  abstraction,  involve  a  uses  a  relationship  because,  when  the 
ProcessEvents  behavior  is  performed,  it  requires  the  use  of  Shipinfo  objects.  At  the  level 
of  specific  events  as  in  the  case  of  Unrep  and  Consol  events,  both  of  these  events  involve 
a  creates  a  relationship  with  SetStation  events. 

Step  (4),  a  C++  design  structure  for  each  of  these  entities,  is  presented  in  detail. 

1.  Battle  Group  Class 

A  real  world  Navy  battle  group  is  characterized  by  its  name  and  designation,  a  set 
of  ships,  and,  for  the  purposes  of  the  BGLCSS  simulation  program,  a  collection  of  trip-wire 
settings.  Tlie  decision  to  design  the  battle  group  class  using  composition  is  based  on  the  has 
a  relationship  that  describes  the  real  world  battle  group  entity.  The  battle  group  has  a  set  of 
settings,  a  location,  a  set  of  ships  and  a  set  of  calculation  results.  With  composition,  all  of 
the  data  and  functions  of  the  first  class  are  reused  in  the  second  class.  For  example,  all  of 
the  Locationinfo  class  data  and  function  members  are  used  in  the  BGlnfo  class  as  well  as 
reused  again  in  the  Shipinfo  class  discussed  later.  This  reuse  is  similar  to  the  nesting  of  the 
Locationinfo  struct  within  the  BGlnfo  and  Shipinfo  structs  in  the  structured  design 
described  in  chapter  IV  except  that  the  functions,  as  well  as  the  data,  are  included. 

While  the  structure  of  the  BGlnfo  class  is  similar  to  its  corresponding  structured 
paradigm  struct,  its  data  members  can  be  hidden  from  outside  the  class.  By  declaring  them 
to  be  private,  they  can  only  be  accessed  by  member  functions  of  the  same  class.  The  array 
of  Shipinfo  objects  and  the  Settingsinfo,  Locationinfo,  and  Resultsinfo  C++  classes 
compose  the  BGlnfo  class  as  shown  in  Figure  37. 
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class  BGInto  { 

private : 

char 

NamefMAXNAME] ; 

char 

Designation[MAXNAME] ; 

Shipinf o 

ShipsIMAXBGSHIPS] ; 

Settingsinfo 

Settings ; 

Locationinfo 

Location; 

Capacityinf o 

Results [MAXBGSHIPS] ; 

public : 

BGInfo ( ) ; 

BGInfo (char*  N, 
-BGInfo ( ) ; 

char*  D,  Settingsinfo*  S) 

void 

SaveBGShips ( Shipinf o  S) ; 

friend  BGInfoSc 

CalculateF7  6  (BGEventSc,  int  i); 

void 

ShowBGShips ( int  i ) ; 

void 

ShowBG ( int  t ) ; 

int 

SaveNewBG (BGInfo  B) ; 

void 

CancelBGdd  I); 

int 

GetBG ( int  i ) ; 

int 

AddBGShip ( int  i,  Shipinf o*  S  ) ; 

int 

DeleteBGShip ( int  i,  Shipinf o*  S) ; 

Locat ioninfo* 

GetBGLocation(int  i); 

int 

SetBGLocation (Locationinfo*  L)  ; 

Capacityinfo 

GetBGResults ( int  i); 

int 

}; 

SetBGResults (Capacityinf o  C) ; 

Figure  37;  Battle  Group  Data  and  Function  Members 

The  choice  to  keep  the  array  as  the  data  structure  to  contain  the  ships  and  battle 
groups  was  made  for  simplicity.  The  array  of  battle  groups,  i.e.  the  array  of  BGInfo  objects 
is  shown  in  Figure  38. 


class  BGArray  { 

private : 

BGInfo 

BG[MAXBGS] ; 

public : 

BGArray  ( ) ; 
-BGArray ( ) ; 
void 

SaveBGs (BGInfo 

B)  ; 

void 

ShowBGs (BGInfo 

B)  ; 

BGInfo 

}  ; 

GetBGs ( ) ; 

Figure  38:  Battle  Group  Array  Data  and  Function  Members 
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2.  Ship  Class  Hierarchy 


Contained  within  the  battle  group  is  the  array  of  ships.  The  object-oriented  ship 
class  is  shown  in  Figure  39.  It  is  a  classic  example  of  a  single  inheritance  class  hierarchy. 
There  are  five  main  classes  derived  from  the  ship  base  class:  Destroyer,  Frigate,  Cruiser, 
Aircraft  Carrier,  and  CLF  Ship.  CLF  Ship  is  funher  divided  into  Ammunition  ship.  Fleet 
Oiler  and  Combat  Support  Ship.  Finally,  at  the  ends  of  the  ship  class  tree  are  the  specific 
ship  types  such  as  DD963,  FFG7,  etc.  This  hierarchy  is  based  on  the  Navy’s  notion  of  ship 
class  which  is  based  on  ship  architecture  and  ship  mission.  BGLCSS,  however,  is  driven 
by  the  ship  type  differences  in  F-76  and  F-44  fuel,  and  ordnance  attributes.  For  instance, 
the  F-76  fuel  capacity  and  F-76  ship  fuel  burn  rate  is  dependent  on  the  Navy  ship  class 
such  as  the  DD963  destroyer  class.  As  far  as  BGLCSS  2.0  is  concerned,  this  makes  all  of 
the  calculations  of  commodity  use  far  simpler  to  modify  and  extend. 


The  base  class,  Shipinfo  class,  as  shown  in  Figure  40,  contains  protected  data 
members  and  public  member  functions,  some  of  which  have  been  declared  virtual.  Base 
class  access  determines  how  the  derived  class  receives  inherited  members. 


.*>6 


Class 

Shiplnto  { 

protected : 

enum  CLFType 

(Air . 

,  Combatant,  Station, Shuttle) ; 

enum  ShipType {Destroyer ,  Frigate, Cruiser ,  AcftCarrier, 

CLFShip} ; 
char 

Name [40] ; 

char 

Hull[10] ; 

CLFType 

TypeCombatant ; 

Locationlnfo 

Location; 

F76Info 

F7  6; 

F44Info 

F44; 

int 

Approach, 

BreakAway ; 

Ordinf o 

Ord; 

Acf tinf o 

Ac  f  t ; 

public : 

ShipInfo();  //constructor 

virtual 

-Shipinfo ( ) ; //destructor 

int 

GetShip(int  t,  char*  c); 

virtual  int 

GetShipType (Shipinfo  s,  int  i)- 

virtual  int 

SetShipType (Shipinfo  s,  int  i ) ; 

virtual  int 

SetCLFType( Shipinfo  s,  int  i) ; 

virtual  int 

GetCLFType (Shipinfo  s,  int  i ) ; 

virtual  int 

SetF76Info(ShipInfo  s,  int  i ) ; 

virtual  int 

GetF76Info(ShipInfo  s,  int  i ) ; 

}; 

class 

char* 

GetShipName ( int  i ) ; 

Destroyerinfo 

:  public  Shipinfo  { 

protected : 

enum  DestroyerType{DD963 ,  DD51}; 

DestroyerType 

DType ; 

public : 

int 

GetShipType (Destroyerinfo  s,  int  i) ; 

int 

SetShipType (Destroyerinfo  s,  int  i); 

int 

SetCLFType (Destroyerinfo  s,  int  i ) ; 

int 

GetCLFType (Destroyerinfo  s,  int  i ) ; 

class 

}  ; 

DD962Info  ;  public 

Destroyerinfo  { 

public ; 

int 

GetF76Info(DD963Info  d,  int  i ) ; 

int 

SetF76Info (DD963Info  d,  int  i); 

//other  commodities  are  similar 

int 

ConsumeF76 ( int  i,  F76Info  f ) ; 

Hit 

FillF76(int  i,  F76Info  f); 

) ; 

//other  commodities  are  similar 

Figure  40:  Ship  Class  Data  and  Function  Members 


Class  access  is  public  for  the  Destroyerinfo  class.  This  means  that  the  base  class’s 
protected  members  remain  protected  (inheritable,  but  still  hidden  from  the  rest  of  the 
program)  and  the  public  members  remain  public.  The  same  is  true  for  the  class  access  of 
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the  DD9631nfo  class.  Destroyerinfo  class  access  is  public  for  the  DD963Info  class.  The 
member  functions  in  this  last  class  are  the  appropriate  place  for  the  DD962  specific 
commodity  values  to  be  initialized.  These  member  functions  were  made  virtual  in  the 
Shiplnfo  base  class  so  that  they  could  be  tailored  for  each  bottom-level  ship  class  such  as 
DD963.  The  ship-specific  enumerated  types  were  encapsulated  within  the  specific  class 
that  they  are  relevant.  By  contrast,  in  the  structured  programming  design,  the  enumerated 
types  are  global  to  the  program. 

3.  Logistics  Events  Class  Hierarchy 

The  logistics  event  classes  are  the  most  challenging  to  design  of  the  BGLCSS 
classes.  When  the  entities  were  identified  in  the  BGLCSS  application  domain,  the  event 
list,  events  in  general,  and  the  twelve  specific  types  of  logistics  events  were  discussed  in 
general  terms.  At  this  point  in  the  analysis,  it  is  possible  to  make  several  class  designs.  We 
will  discuss  two  specific  designs,  the  first  of  which  is  shown  in  Figure  41 . 


Figure  41;  BGLCSS  Event  Class  Hierarchy  With  Twelve  Derived  Classes 

First,  the  twelve  BGLCSS  logistics  events  could  placed  in  a  cla.ss  hierarchy  where 
there  is  one  abstract  base  class  from  which  all  twelve  logistics  event  classes  are  derived. 
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Although  an  end  user  might  visualize  the  twelve  BGLCSS  events  in  this  way,  a 
class  hierarchy  of  this  design  does  little  to  support  code  reuse.  This  is  because,  when 
describing  the  entity  behaviors  or  functions  in  detail  as  outlined  in  step  (2)  of  the  object- 
oriented  programming  paradigm  methodology,  the  patterns  shown  in  Table  9  become  clear. 


Table  7;  BGLCSS  EVENT  COMMON  FUNCTIONS 


Affects  F-76  Level 

Affects  F-44  Level 

Affects  Ordnance  Level 

BGCourseSpeed 

Yes 

SetShipStation 

Yes 

ShipCourseSpeed 

Yes 

FuelTransfer 

Yes 

Yes 

AAWThreatLevel 

Yes 

Strike 

Yes 

Unrep 

Yes 

Yes 

Yes 

Consol 

Yes 

Yes 

Yes 

ASWThreaiLevel 

Yes 

Yes 

Raid 

Yes 

Yes 

OrdnanceTransfer 

Yes 

ASW  Pro.seculion 

Yes 

Each  of  these  events  affects  a  different  combination  of  the  F-76,  F-44,  and 
ordnance  commodities  and  would  require  duplicated  code  regarding  the  calculations  of 
commodity  levels. 

At  this  point,  it  is  useful  to  draw  a  distinction  between  the  problem  domain  and 
the  program  domain.  The  problem  domain  refers  to  the  real  world  problem  that  the 
.software  is  intended  to  .solve.  In  contrast  to  the  structured  programming  paradigm,  the 
object-oriented  programming  paradigm  focuses  on  closely  mapping  die  entities  in  the  real 
world,  the  problem  domain,  to  entities  in  software.  The  program  domain  differs  from  the 
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problem  domain  in  that  it  represents  the  programming  language,  operating  system,  and 
programming  paradigm.Writing  a  program  consists  of  building  a  solution  within  the 
program  domain  to  solve  a  problem  in  the  problem  domain. 

The  most  straightforward  approach  is  to  first  solve  the  problem  within  the 
problem  domain,  then  construct  a  model  of  the  problem  domain  within  the  program  domain 
and  map  the  solution  over.  The  more  explicit  the  model,  the  more  obvious  the  mapping  and 
the  easier  it  becomes  to  write  and  understand  the  resulting  program.  [DAVIS  92].  Since  the 
problem  domain  of  BGLCSS  is  to  generate  percent  capacity  states  for  F-76,  F-44,  and 
ordnance  for  ships  and  battle  groups,  this  distinction  was  used  to  determine  whether 
clusterings  of  similar  event  behaviors  was  present.  Table  7  clearly  shows  that  there  are 
common  behaviors/functions  among  the  events. 

The  solution  to  designing  a  class  hierarchy  that  promotes  code  reuse  involve 
multiple  inheritance.  Multiple  inheritance  permits  a  class  to  be  derived  from  two  or  more 
base  classes.  With  this  kind  of  construction,  class  relationships  become  much  more 
involved  than  with  single  inheritance.  Under  single  inheritance,  the  inheritance  hierarchy 
is  a  tree;  under  multiple  inheritance,  the  hierarchy  is  a  directed  acyclic  graph.  Cargill  makes 
a  distinction  between  synthetic  and  natural  classes.  Synthetic  classes  do  not  correspond  to 
abstractions  found  in  the  application  problem  domain.  Synthetic  classes  emerge  during 
design  and  coding  of  a  system  in  response  to  internal,  synthetic  needs  of  the  software.  This 
is  in  contrast  to  natural  classes,  those  that  correspond  to  abstractions  from  the  problem 
domain  and  typically  arise  either  during  analysis  or  early  design.  A  simple  criterion  is  to 
ask  end  users  if  they  recognize  the  abstraction.  Because  a  natural  class  comes  from  the 
problem  domain,  an  end  user  will  understand  its  purpose;  a  synthetic  class  arises  only  from 
.software  implementation  considerations,  so  the  end  user  will  not  appreciate  the  need  for  it 
[CARGILL  92j. 

The  BGLCSS  2.0  event  classes  are  more  complex  than  the  ship  classes  because, 
in  order  to  maximize  reu.se  of  cla.ss  member  functions,  multiple  inheritance  is  neces.sary. 
Instead  of  a  tree  structure  as  in  the  ship  classes,  the  event  class  is  a  directed  acyclic  graph. 
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where  the  classes  lower  on  the  tree  inherit  from  the  classes  connected  above  them.  TTiis 
design  decision  is  based  on  the  common  denominators  of  the  logistics  events,  in  other 
words,  these  events  either  affect  F-76,  F-44,  or  ordnance,  or  a  combination  of  these.  There 
are  no  is  a  relationships.  The  class  hierarchy  is  just  a  convenience  to  reuse  code, 
particularly  the  member  functions  of  the  commodity  affecting  classes.  There  is  no  domain 
specific  relationship. 


Figure  42:  Logistics  Event  Class  Hierarchy  With  Three  Synthetic  Derived  Classes 

The  C++  class  definition  for  the  logistics  event  class  is  provided  in  Figure  43.  The 
enumerated  types  specific  to  the  events  are  encapsulated  within  the  abstract  base  class 
BGEvent. 


class  BGEvent  { 
protected : 

enum  BGEventType  {BGCourseSpeed,  ASWLevel,  AAWLevel, 
SetStation,  ShipCourseSpeed,  Unrep,  Consol, 
FuelTransfer ,  OrdTransfer,  RaidEvent,  StrikeEvent, 
ASWProsecute,  ResuzneBGCourseSpeed,  Other); 

enum  PredictType  {Orphan,  Child,  Parent , Interval ) ; 

enum  ThreatType  (Low,  Med,  High,  Raid,  Strike,  Asw) ; 

enum  CalcType  {Ord,  F76,  F44,  BothFuel,  All); 

BGEvent  *Prev, 

♦Next ; 

int  DTG, 

Index, 

Created, 

Predictinterval ; 

BGEventType  EType ; 

PredictType  PType; 

CalcType  CType; 

Directioninfo  Direction; 

public : 

BGEvent ( ) ; 

-BGEvent ( ) ; 

)  ; 

class  F76Event  :  public  BGEvent  { 
public : 

friend  BGInfot  BGInfo:  :CalculateF7  6  (BGEventSt,  int  i )  ; 


)  ; 

class  Unrep 
public : 


)  ; 


public  P76Event  { 
Unrepinfo  UnrepData; 


Figure  43:  BGEvent  Class  Data  and  Function 

Whereas  in  the  BGInfo  struct  in  the  structured  programming  design  described  in 
chapter  IV  contained  the  Unrepinfo,  ThreatType,  Strikelnfo,  Raidinfo,  and  ASWInfo 
structs,  they  are  omitted  from  the  BGInfo  abstract  base  class.  Instead,  these  objects  are 
contained  only  in  the  appropriate  bottom  level  class  objects.  For  instance,  the  Unrepinfo 
object  would  be  contained  in  the  Unrep  class  only.  This  design  is  more  representative  of 
the  real  world  entities  and  makes  future  modifications  and  extensions  easier  to  perform 
because  all  of  the  underway  replenishment  data  and  functions  are  localized  to  the  one  class 
where  this  information  is  relevent. 
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When  a  function  manipulates  objects  of  two  distinct  classes,  the  function  can  be 
made  a  friend  function  to  both  classes.  This  is  what  is  done  with  the  CalculateF76  function 
which  illustrates  the  uses  a  relationship  between  the  BGEvent  class  and  the  BGInfo  class. 
This  function  was  made  a  friend  to  both  classes. 

As  far  as  code  reuse  is  concerned,  with  C++  version  2.1,  the  events  classes 
discussed  so  far  provide  only  limited  code  reuse  when  considering  that  the  BGLCSS 
application  has  three  doubly  linked  lists,  each  performing  insertion,  deletion,  search,  etc. 
Using  this  event  hierarchy  as  is  would  involve  creating  three  classes  for  each  of  the  doubly 
linked  lists.  Each  of  these  data  structures  could  only  handle  specific  objects.  To  capture 
maximum  code  reuse  for  the  logistics  events  and  list  operations  in  BGLCSS,  a  feature 
supported  in  C++  3.0  is  needed.  Templates  provide  a  solution  to  this  code  duplication 
problem.  Template  classes  model  generic  objects  that  provide  similar  operations  for 
different  data  types.  By  using  a  template  class,  as  shown  in  Figure  44,  a  generic  double 
linked  list  can  be  instantiated  for  pre-defined  and  user-defined  types. 


template  <class 
class  List  { 
protected : 

struct  Node  ( 

T  Data; 

Node*  Prev; 

Node*  Next ; 

)  ; 

Node  *Nodeptr; 

Node  *Headptr; 
public : 

List  (  )  ; 

~List ( ) ; 

virtual  InsertNode (T) ; 
virtual  DeleteNode (T&  node) ; 
virtual  SearchNode  (TSt  node); 

)  ; 


Figure  44:  BGLCSS  Template  List  Class 


In  BGLCSS,  we  could  instantiate  three  List  classes  using  the  three  different 
objects:  BGEvents,  BGHeader,  and  Relation.  Then,  from  the  BGEvents  abstract  base  class. 


the  synthetic  commodity  affecting  classes  would  be  derived.  Finally,  the  twelve  logistics 
events  would  be  derived  from  the  appropriate  set  or  sets  of  synthetic  commodity  affecting 
classes 

B.  SYMBOLIC  CONSTANTS 

Instead  of  using  the  preprocessor  directive  #de£ine  to  define  program  constants  and 
string  literals,  C++  and  ANSI  C  provide  const  to  reserve  storage  for  data  that  is  read-only 
as  shown  in  Figure  45.The  drawback  to  using  #de£ine  is  that  is  does  no  type  checking. 
Any  value  can  be  given  to  #de£ine  without  regard  to  proper  type  checking.  The  lack  of 
proper  type  checking  is  one  of  C’s  weaknesses  that  can  pose  enormous  problems  for  the 
programmer  when  trying  to  trace  bugs  in  code. 


const 

int 

MAXNAME 

25  ; 

const 

i  nt 

KAXF76COEF 

= 

3  ; 

const 

int 

MAXSHIPTYPEE 

8; 

const 

i  nt 

MAXORD 

= 

100; 

const 

i  nt 

MAXACFT 

20; 

const 

int 

MAXTHREATLEVELS 

= 

0  . 

•-  / 

const 

i  nt 

MAX INTERVALS 

= 

3; 

const 

int 

MAX  ENGAGEMENTS 

= 

. 

const 

int 

HOURS INDAY 

2  3  ; 

const 

int 

MAXUSETYPES 

= 

c  . 

j  / 

const 

int 

MAXBGSHIPS 

= 

3  0 ; 

const 

int 

MAXBGS 

= 

1  0 ; 

const 

i  nt 

MAXORD 

= 

:oo; 

con. St 

i  nt 

MAXSHIPS 

r 

1  OC  ; 

const 

int 

DTGLENGTH 

= 

•  Cj  . 

const 

i  nt 

MAXLENGTH 

= 

2B; 

const 

cha 

F76DATA[ ! 

= 

•  /h/bgl css/ 

scripts.' data/F7';  .dat " ; 

const 

cha 

BGDATA  t ! 

= 

"  /h/ bglcss/ 

scripts /da ta/BGDat a . dat " ; 

const 

cha  t 

BGSHIPS 1 ) 

”/h/bcJcss/ 

scripts/data/Ships" ; 

const 

char 

NAVYSHIPS ! 1 

= 

”  /h/bglitss/ 

sc  i  ipt  s/da  ta  /Na'vCv’Eh ;  ps  .  da  t  "  ; 

const 

cha ! 

EVENTEtATA I  1 

■■/h/bcl  css; 

sc :■  i  r,t  s.' d.a :  j  Ecenr  c " ; 

Figure  45:  Symbolic  Constants  for  Battle  Groups  and  Ships 

C.  OBJECT-ORIENTED  DESIGN  BENEFITS 

This  description  of  object-oriented  mechanisms  when  applied  to  the  BGLCSS 
application  domain,  provided  examples  of  ease  of  modification  ,  extension,  and  code  reuse. 
Ease  of  modification  and  extension  are  the  natural  by-products  of  a  class  structure  where 
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data  and  function  are  encapsulated.  The  program  is  easier  to  modify  because  the  data  and 
functions  are  not  separate  and  instead  would  work  together.  The  clutter  of  the  similarly 
named  functions  such  as  InsertBGEvent,  InsertBGHeader,  and  InsertRelation  would  be 
replaced  by  the  use  of  polynorphism  where  the  respective  object  is  sent  a  message  such 
as  Insert. 

The  Shiplnfo  class  hierarchy  that  derived  specialized  classes  for  each  Navy  ship  class 
such  as  DD-963  provided  a  better  way  to  perform  Navy  class-specific  commodity 
information. 

Code  reuse  was  to  a  limited  extent  accomplished  with  the  use  of  synthetic  classes  in 
the  BGEvent  class  hierarchy.  A  more  substantial  degree  of  code  reuse  could  be  achieved 
by  using  a  list  template  class  for  all  three  of  the  inked  list  structures. 
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VI.  CONCLUSION  AND  RECOMMENDATIONS 


The  structured  and  object-oriented  designs  of  the  same  program,  BGLCSS  2.0,  were 
presented  and  the  merits  of  the  application  of  each  paradigm  were  discussed.  It  is  clear  that 
there  are  numerous  technical  benefits  to  using  an  object-oriented  programming  paradigm 
instead  of  a  structured  programming  paradigm  for  systems  expected  to  evolve  over  time. 

There  is  little  doubt  that  Command,  Control,  and  Communications  (C  )  applications  such 
as  the  BGLCSS  tactical  decision  aid  will  be  refined  and  extended  as  battle  group 
coordinators  use  the  system  and  identify  additional  components  to  be  added  or  existing 
ones  to  be  changed.  In  fact,  one  thesis  currently  being  developed  by  an  Operations  Research 
Department  student  at  the  Naval  Postgraduate  School  involves  a  modified  version  of  the 
underway  replenishment  event  within  BGLCSS. 

The  initial  drawback  to  moving  to  an  object-oriented  programming  paradigm  can  be 
characterized  as  the  trade-off  between  long-term  planning  and  design  versus  short-term 
production  gains.  At  the  beginning  of  a  move  to  an  object-oriented  approach,  a  substantial 
amount  of  time  is  required  to  study  the  paradigm  and  produce  an  overall  design  for  the 
classes  and  their  hierarchies  in  the  application.  By  contrast,  accepting  the  status  quo  and 
remaining  within  a  structured  programming  paradigm  requires  no  extra  effort.  In  a  world 
of  time  constraints,  decisions  are  frequently  made  to  quickly  produce  a  software  application 
prototype  and  delay  concern  about  modification  and  extension  until  a  later  time.  While  this 
reasoning  has  dominated  many  software  development  projects,  it  is  recommended  that 
organizations  such  as  the  Navy  Space  and  Warfare  Command  which  is  in  charge  of 
managing  large  software  systems  pursue  moving  towards  adopting  an  object-oriented 
paradigm  in  the  future.  The  long-term  benefits  outweigh  the  short-term  benefits.  It  is  also 
recommended  that  NTCS-A  applications  programmers  consider  using  TAE  Plus  to  build 
their  graphical  user  interfaces  instead  of  using  low-level  Motif  functions.  A  high-level  tool 
such  as  TAE  Plus  greatly  reduced  BGLCSS  graphical  user  interface  development  time. 
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APPENDIX  A.  BGLCSS  2.0  GRAPHICAL  USER  INTERFACE 

PANELS 


Figure  46:  BGLCSS  2.0  Set  Up  Battle  Groups  Initial  Panel 


Figure  47:  BGLCSS  2.0  New  Battle  Group  Data  Panel 
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Figure  49;  BGLCSS  2.0  Battle  Group  Ships  Panel 
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Figure  50:  BGLCSS  2.0  Ship  Logistics  Panel 
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Figure  51:  BGLCSS  2.0  Ship  F-76  Fuel  Panel 
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Figure  52:  BGLCSS  2.0  Ship  F-44  Fuel  Panel 


Figure  53:  BGLCSS  2.0  Select  Ordnance  Panel 
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Figure  55:  BGLCSS  2.0  Ordnance  Data  Panel 
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Figure  56;  BGLCSS  2.0  Aircraft  Load  Panel 


Figure  57:  BCiLCSS  2.0  Aircraft  Data  Panel 
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Figure  60:  BGLCSS  2.0  ASW  Threat  Level  Panel 
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Figure  66:  BGLCSS  2.0  Underway  Replenishment  Results  Panel 
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Figure  73:  BGLCSS  2.0  Raid  Ships  Panel 


Figure  74:  BGLCSS  2.0  Strike  Panel 
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Figure  79;  BGLCSS  2.0  Select  Ship  Aircraft  Panel 


Figure  80:  BGLCSS  2.0  Select  Summary  Report  Panel 
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Figure  8 1 :  BGLCSS  2.0  Battle  Group  Shuttle  Requirements  Report  Panel 


Figure  82:  BGLCSS  2.0  Commodity  List  Panel 
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Figure  83;  BGLCSS  2.0  BG  Summary  By  Single  Commodity  Panel 


Figure  84:  BGLCSS  2.0  Battle  Group  Selection  Message  Panel 
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Figure  85:  BGLCSS  2.0  Ship  Selection  Message  Panel 


Figure  86:  BGLCSS  2.0  Insufficient  Data  Message  Panel 


Figure  87:  BGLCSS  2.0  Print  Job  Message  Panel 
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Figure  88:  BGLCSS  2.0  Incorrect  DTG  Format  Message  Panel 


Figure  89:  BGLCSS  2.0  Incorrect  Lat/Long  Format  Message  Panel 


Figure  90:  BGLCSS  2.0  Close  All  Events  Panels  Message  Panel 
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Figure  92:  BGLCSS  2.0  Event  List  Panel 
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Figure  93:  BGLCSS  2.0  Sample  Help  Panel 
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Figure  94:  BGLCSS  2.0  Overview  Initial  Panel 
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APPENDIX  B.  BGLCSS  2.0  C  PROGRAM  LISTING 


Files  Common  to  BGSetup  and  BGEvents  modules: 

bg.h 

bg.c 

BGEventsLib.h 

BGEventsLib.c 

global.h 

pan_WptHelp.c 

pan_WptHelp.h 

wpthelp.c 

wpthelp_creat_init.c 

wpthelp_init_pan.c 

Files  Specific  to  BGSetup: 

BGSetup.c 

BGSetup_creat_init.c 

BGSetup_init_pan.c 

Imakefiie 

pan_BGData.c 

pan_BGData.h 

pan_BGShips.c 

pan_BGShips.h 

pan_CloseAll.c 

pan_CloseAJl.h 

pan_DelBG.c 

pan_DelBG.h 

pan_Dtg.c 

pan_Dtg.h 

pan_LackData.c 

pan_LackData.h 

pan_NewBG.c 

pan_NewBG.h 

pan_SaveNewB.c 

pan_SaveNewB.h 

pan_SeIBG.c 

pan_SelBG.h 

pan_SetUpBGs.c 

pan_SelUpBGs.h 

pan_Ship.c 

pan_Ship.h 

Files  Specific  to  BGEvents  module: 

BGEvents.c 

BGEvents_creat_init.c 

BGEvents_init_pan.c 

Imakefiie 

pan_BGCrsSpd.c 

pan_BGCrsSpd.h 

pan_BGEvents.c 

pan_BGEvents.h 

Files  Specific  to  Overview  module: 

Overview.c 
Overview_creat_init.c 
Overview_init_pan  .c 
pan_Overview.c 
Pan_Overview.h 
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yi)i*«***************>tc4<***4<*4t**4i***<l>***«**4<****'**«%*i|i4<**4>4<***4t«**<)'*** 


♦Author 

♦Office 

♦ 

* 

♦Project 

♦Advisor 

* 

4c 

4c 


4c 

♦Filename 

♦Date 

♦Content 

4> 

♦Note 


Bernadette  C.  Brooks 
Computer  Science  Department 
Naval  Postgraduate  School 
Monterey,  CA  93943 
Phone:  (408)  656-2180 

Dr.  C.  Thomas  Wu 
Computer  Science  Department 
Navjil  Postgraduate  School 
Monterey,  CA  93943 
Phone:  (408)  656-3391 
bg.h 

27  Feb  93 

C  manifests,  data  type  definitions,  and  data 
structure  definitions  for  all  of  BGLCSS  2.0 
“global.h”  TAE-generated  file  includes  bg.h 


4i  4c  4t  4i  4t  4t  4c  4(  4i  4(  4i  4c  4c  4i  4c  4c  4e  4(  4t  4<  4c  4c  4c  4(  4c  4c  4c  4(  4c  4c  4c  4(  4t  4c  4c  4(  4i  4i  4c  4c  4(  4c  4c  4c  4i  4c  4c  4c  4i  4(  4c  4c  4c  4c  #  4c  4c  4c  4c  4c  4(  4c 


♦/ 


#include  <stdio.h> 
#include  <stdlib.h> 


#define  MAXNAME 
#define  MAXF76COEF 
#define  MAXSHIPTYPES 
#define  MAXORD 
#define  MAXACFT 
#define  MAXTHREATLEVELS 
#define  MAXENGAGEMENTS 
#define  MAXINTERVALS 
#define  HOURSINDAY 
#define  MAXUSETYPES 
#define  MAXBGSHIPS 
#define  MAXBGS 

#define  MAXORD 
#define  MAXSHIPS 
#define  DTGLENGTH 
#define  MAXLENGTH 

#define  F76DATA 
#define  BGDATA 
fdefine  BGSHIPS 
#define  NAVYSHIPS 
#define  EVENTSDATA 
#define  HEADERS  DATA 


25 

3 

8 

100 

20 

2  /♦  Low,  Medium,  High  ♦/ 

2  /♦  Raid,  Strike,  ASW  ♦/ 

3 

23 

5 

30 

10 

100 

100 

15 

25 

"/h/bglcss/scripts/data/F76.dat” 

“/hA»glcss/scripis/data/BGData.dai" 

“/hA)glcss/scripts/data/Ships” 

“/h/bglcss/scripts/data/NavyShips.dat” 

“/h/bglcss/scripts/data/Events” 

“/hA)glcss/scripts/data/Headers'' 


enum  CLFType  | 

Air, 

Combatant, 

Station, 

Shunle 

); 


typedef  enum  CLFType  CLFType; 
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y  4t  4t  4t  4t  4c  4t  4t  4  ^  4c  4c  4c  4t  4t  4t  4;  4c  4c  %  4c  4c  4c  4c  4c  4:^ 


enum  AcftType  ( 
F14, 
FA18, 
A6, 
EA6B. 
E2 


typedef  enum  AcftType  AcftType; 


l^4,iHi*^}t,^,**^^**^:7t,*^t**^,ittm******>ti******************>it******Ai*********m*^‘****l 

typedef  struct  { 

int  Capacity, 

ReceiveRate, 

TransferRate, 

OnHand, 

EstOnHand, 

Dtg; 

float  Coef[MAXF76COEF]; 

}F76Info; 

y4(4i4<44c4c4c4(4t4c4c4i4c4t4c4c4<4i4t4t44>4c4c4c4i4c4e4c4c4c4c4c4c4t4c4c4c4c4t4c4t4c4t4c4E4t4c4444t4i4c4c4c4c44c444c4c4444t44t44c  j 


typedef  struct  | 

int  Capacity, 

ReceiveRate, 

TransferRate, 

OnHand, 

EstOnHand, 

Dig; 

lF44Info; 

y4t4e4c4c4t4c4(4c4c4c44c4<4(4c4c4>4(4c4c4(4c44c4c4>4c4c4c4c4c444c4>4c4t4E4c4c4c4i4c4(4c4(4c4c444t444c4c4c4c44>4c44c4t4c4c44i44c4t4y 


typedef  struct  { 
int 
float 

double 


ILocationlnfo; 


Dtg; 

Speed, 

MaxSpeed; 

Latitude. 

Longitude, 

Course; 


|m^^**^^**^^**^l•^^****i*^^******i**^^*‘^l*^^***i^***^^*****^^****i**^**i****i*i^*l:^i^i^^*:*^*m*j 


typedef  struct  | 

int  QuantstylMAXUSETYPESl; 

}OrdUse; 

y**^]k4i4[4i4t4c44  4<4444  4t44c444  44c4c4t4c4c4(4c44c4<4(4c44t4c4c444i4444c44i444t44c4c4<444(44  44t4t44t4t4c44t44  j 


typedef  struct  { 

char  Name[MAXNAME]; 
lOrdName; 
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y*«4<*4i«***  ***********  ***4i4i*>)i**4i:«>*iti**4i*4<4<****4t«>l<'«i*<*****«*i»******4>4<*******y 


typedef  struct  | 

OrdName  Namc[MAXORDl; 

int  TotalNumber, 

Capacity[MAXORD), 

Range[MAXORD]. 

TransferRate[MAXORD], 

OnHand[MAXORDl, 

EstOnHand[MAXORD]. 

OnHandDtg[MAXORD], 

EstOnHandDtg[MAXORD]; 

OrdUse  UseRatelMAXORDj; 

lOrdInfo; 

y*********************************************************************** 


typedef  struct  { 

AcftType 

AType; 

int 

NumberAcft, 

FuelBumedSortie. 

MaxSortiesDay; 

int 

SortieRate[MAXTHREATLEVELS]; 

int 

NumSorties[MAXENG  AGEMENTS  ]; 

}  AcftRecord; 

f*********** ************************************************************ 


typedef  struct  { 

int  SortieFlown[HOURSINDAY]; 

AcftRecord  Wing[MAXACFT]; 

lAcftlnfo; 


typedef  struct  | 
char 
char 

CLFType 

Locationinfo 

F76Info 

F44Info 

int 

Ordinfo 

Acftlnfo 

IShiplnfo; 


Nanie[40]; 

HuU[10]; 

TypeCombatant; 

Location; 

F76; 

F44; 

Approach, 

BreakAway; 

Ord; 

Acft; 


typedef  struct  j 

char  ShipType[101; 
int  F7^apacity, 

F76Receive. 
F76Transfer; 

float  CoeflMAXF76COEF]; 

|F76ShipTypeInfo; 


95 


typedef  struct  { 

float  FuelRes, 

CLFFuelRes, 

OrdRes. 

CLFOrdRes. 

MaxF76. 

MaxF44, 

StationSpeed, 

UnrepSpeed. 

AcftShipSpeed; 
int  PredictStart: 

int  PredictHours[MAXINTERVALSl; 

ISettingslnfo; 


typedef  struct! 

int  TotalNumber: 
lOrdCz^jInfo; 

^*4i4t**4t*****«;<>«*******************«*****************4i  *************  *******4>**y 

typedef  struct! 

fioat  F76Capacity[i  1AXINTERVALS]. 

F44Capacity[MAX[NTCRVALSl; 

OrdCapInfo  OrdCapacity[MAXINTERVALS]; 

}CapacityInfo; 

typedef  struct ! 

char  NamefMAXNAME]; 

char  DesignationfMAXNAME}; 

Settingslnfo  Settings; 

Locationinfo  Location; 

Shipinfo  Ships[MAXBGSHIPS]; 

Capacitylnfo  ResultsIMAXBGSHIPSI; 

IBGlnfo; 
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im;^^^m***m************  ******<!>************************************** 

♦Author  Bernadette  C.  Brooks 

♦Office  Computer  Science  Department 

♦  Navi  Postgraduate  School 

♦  Monterey,  CA  93943 

♦  Phone:(408)656-2180 
♦Project 

♦Advisor  Dr.  C.  Thomas  Wu 

♦  Computer  Science  Department 

♦  Naval  Postgraduate  School 

♦  Monterey,  C  A  93943 

♦  Phone:  (408)656-3391 

♦Filename  :  bg.c 

♦Date  27  Feb  93 

♦Content  Bodies  of  user-defined  functions  to  represent  battle 

♦  groups  and  ships.  C  manifests  contained  in  bg.h 

♦Note  “global.h”  TAE-generated  file  includes  bg.h 

♦/ 

^include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <math.h> 

/♦TAE  system  include  files^/ 

#include  “taeconf.inp" 

#include  "wptinc.inp" 

(tinclude  "symtab.inc" 

#include  “parblk.inc” 

#include  “terminc.inc” 

#include  "global.h" 

♦  Convert  an  integer  to  the  appropriate  string  representation  of 

♦  TypeCombatant.  C  stores  the  value  of  an  enumerated  type  in  an 

♦  ASCII  file  as  an  integer.  To  display  this  value  in  a  panel,  it  must  be 

♦  converted  to  a  str^i^. 

♦/ 

char*  ConvertTypeCombatant  (Integer) 
int  Integer, 

I 

char  TempString(MAXNAMEl; 
switch  (Integer)  | 
case  0: 

strcpy(TcmpString,  "Aviation"); 
break; 

case  1; 

strcpy(TempString,  "Combatant"); 
breic; 

case  2; 

strcpy(TeinpString,  "Station  CLF”); 
breic; 

case  3: 

strcpy(TempString,  "Shuttle"); 
breic; 

default: 
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strcpy(TempString,  “unknown”); 


retum(TempString); 


4c  4c  4c  4c  ^  ^  4c  4t  4c  4c  * 

*  Convert  an  integer  to  its  appropriate  string  representation. 

*  UNIX  K  &  R  C  library  does  not  contain  this  kind  of  function. 

*  DOS  C  does.  It  is  needed  for  I/O  to  the  ASCII  text  files  containing 

*  ship,  battle  group,  and  event  information. 

4i  4c  4c  4(  4c  4c  4c  4c  4i  4c  4(  4c  4c  4c  4c  4c  4i  4c  41 4c  4c  4(  4c  4(  4c  3^  4c  4c  4c  4c  4c  4c  4c  4i  4c  4c  4t  4c  4c  4t  4t  4t  4c  4c  3^  4c  4t  *  4t  4c  4c  4c  4c  4c  4c  4(  4c  4c 


char*  IntToString(i) 
int  i; 


swi!ch(i)| 
case  0: 

retum("0”);  break 

case  1: 


case  2: 
case  3: 
case  4; 
case  5: 
case 
case  7: 
case  8: 
case  9: 
case  10: 
default: 


retumC'!");  break; 
retum("2”);  break; 
retum(“3");  break; 
retum(“4”):  break; 
retum(“5”);  break; 
retum(“6”);  break; 
retum(“7”);  break; 
retum(“8”):  break; 
retiim(“9”);  break; 
retum(“10");  break: 
retumfl  1"); 


yi^*4c^**4(«^3te4c4c4c34  •  4c4c4c3^4c4c4t4c*4c4c4c4c4c4c3^4c4c4c4c4c4c4c4c3>4c4c4c4c4c4c4c4c4c4c4i4c4t4c4c4c4t4t4c 

*  Using  the  string  of  a  ship  name  and  the  index  to  the  appropriate  battle 

*  group.  GetShip  returns  the  ship  index  for  the  appropriate  ship. 

4c4c4c4(4c^4(4i**4c4c*4c4c4c4c4c4c**4c4c4e4c4c4c4>4i4c4c4>4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c 

♦/ 

int  GetShip(N;une,  i) 

char  N;unc[MAXNAME]; 

int  i; 

I 

char  FileName[80]; 

FILE*  DataFile; 

char  SuffixfMAXNAME); 

TEXT*  tempIMAXBGS); 
char  CmdlMAXNAME); 

int  s; 

char  bufllO]: 
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strcpy(FileName,  BGSHIPS); 

strcpy(Suffix.IntToString(i)); 

strcat(Suffix,  “.dat”); 

strcat(FileNanie,  Suffix); 

DataFiJe  =  fopen(FileName,  “r”); 

while  (!feof(DataFile))| 

fscanf(DaiaFile.”%[''\n]\n”,  Cmd); 
s  =  0; 

/"■skip  over  all  ship  info*/ 
for  (s  =  0;  s  <  13;  s++)i 

fscanf(DaiaFile.”%s\n”.  buf); 

1 


if  (strcmp(Name,Cmd)  ==  0){ 
Found  =  1; 

I  else  I 


fclose(DataFile); 

if  (Found  =  0){ 

retum(- 1 ); 

I  else  I 

retum(i); 

I 


^*m***^i************m:Hi*****************m******************** 

*  This  function  uses  TAE  functions  to  display  values  to  the  Ship  panel. 

**************** ***•«« ********«******4,«*ik«4t«*4i**«**  ;.«****** 
*/ 

void  ShowShipfPanelView,  Panelld.  BGs.  i,  s) 

Id  PanelView, 

Panelld; 

BGInfo  BGs[MAXBGS]; 
int  i. 


TEXT*  name[l]; 

TEXT*  huUdl; 

strcpy(name[01,BGs(i].Shipslsl.Name); 

Vm_SetString(Panel  View.’'ShipNanie.textstrs’M  ,name.P_UPD  ATE); 
Wpt_ViewUpdaie(PanelId."ShipName”,  Panel  View.”ShipName”); 


strcpy(hull[0],BGs(i].Ships(s].Hull); 
Vm_SetString(PanelView."Hull.textstrs",l.hullJ*_UPDATE); 
Wpt_ViewUpdate(PanelId."Huir’,  PanelView,"HuH”); 


strcpy(naine[0]3Gs(i].Naine); 

Vm_SetString(Panel  View,”BGNanie.textstrs”.  1  .name  J*_UPDATE); 
Wpt_ViewUpdate(Panelld.”BGName",  PanelView,”BGName"); 

strcpy(name[0]. 

ConvertTypeCombatant(BGs(i].ShipsIsl.TypeCombatant)); 


Vm_SetString 

(PanelView,’TypeCombatant.textstrs”.l,name.P_UPDATE): 

Wpt_ViewUpdate(PanelId,’TypeCombatant”. 

PanelView.’TypeCombatant”); 

strcpy(name[0],dtg_to_a(BGs[i].Ships(s].Location.Dtg)); 
Vm_SetString(PanelView.”Dtg.textsirs’M,nameP_UPDATE); 
Wpt_ViewUpdate(PanelId,”Dtg”.  PanelView,'’Dtg”); 

Wpt_SetIntg(PanelId,  "Approach”,  20); 

Wpt_SetIntg(PanelId,  “BreakAway’MO); 


y  4c  4c  4c  4c  4c  4c  4^  4t  %  %  4i  ^  ]|i  4c  ^  ^  ]|t  4c  ^  It  4c  4c  *  %  1(1 %  %  4t  3(1 

*  This  function  uses  TAE  functions  to  display  values  to  the  Ship  panel 

^t**^,***ii,***************************************’(t*v****<it**** 

*1 


void  ShowF76  (BGs.  i,  s,  Panelld,  PanelView) 

BGlnfo  BGs[MAXBGS]; 
int  i: 

int  s; 

Id  Panelld, 

PanelView; 

{ 

TEXT*  name[l]; 

TEXT*  estonhand[lj; 

TEXT*  estdtgH): 

strcpy(name[0].  BGs[i].Ships[s].Name); 

Vm_SetString(PanelView,  "Name.textstrs”,  1,  name.  P_UPDATE); 
Wpt_ViewUpdate(PanelId.  "Name”,  PanelView,  “Name”); 

Wpt_SetIntg(PaneUd,  "OnHand”.  BGs(i].Ships[s).F76.0nHand); 
Wpt_Setlntg(PaneUd,  "Capacity”,  BGs[il.Shipslsl.F76.Capacity); 

/*not  implemented  yet*/ 

/*Vm_SetString(PanelView.  “EstOnHand.textstrs”.  1. 
estonhand.  P_UPDATE); 

Wpt_ViewUpdate(PanelId,  "EstOnHand”.  PanelView.  "EstOnHand”);*/ 


/*need  to  conven  date  integer  to  string  representations  first*/ 

/*not  implemented  yet*/ 

/*Vm_SetString(PanelView.  "EstDtg.textstrs",  l.estdtg,  P_UPDATE); 
Wpt_ViewUpd^e(Panelld.  “EstDtg”,  PanelView.  “EstDtg”); 


/*not  implemented  yet*/ 
/*Wpt_SetIntg(Panelld.“ReceiveRate”. 
BGs[i].Ships(s].F76.ReceiveRate); 
Wpt_SetIntg(PanelId. 
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} 


“TransferRate”,BGs[il.Ships(s].F76.TransferRate); 

V 


4c  4t  %  #  ^  #  4t  4e  4i  4c  ^  4c  9|t  4c4t  4c  4c  %  4t  4c  4t  4t  4t  4c  ^  ^  %  4t  4c  4c 

*  Using  the  BG  anay  and  the  index  to  the  specific  battle  group,  this 

*  function  saves  the  battle  group’s  ships’  data  to  an  ASCII  text  file. 


void  SaveBGShips(BGs,i) 

BGInfo  BGs[MAXBGS]; 
int  i; 

( 

char  FileNamellOO]; 
char  Suffix[MAXNAME]; 

static  blank[MAXNAME]; 

FILE*  DataFile; 

int  s; 

int  Index; 

static  char  Cmd[  100); 

s=  0: 

/♦Based  on  BG  Index,  create  appropriate  file  name  for  BG  ships.  Ex: 
For  ships  in  BGs[0],  filename  is  /h^glcss/scripts/daia/ShipsO.dat*/ 

strcpy(FiIeName,  BGSHIPS); 
strcpy(Suffix,IntToString(i)); 
strcatfSuffix,  “.dat”): 
strcatfFileName.  Suffix); 

/♦use  system  call  to  remove  previous  file*/ 
strcpyfCmd,  “rm  “); 
strcatfCmd.  FileName); 
system(Cmd); 

DataFile  =  fopen  (FileName,  “w”); 

/♦Fill  in  F76  Table  for  ships  by  type*/ 

/♦Read  in  Shipinfo  for  ships  in  this  BG  from  appropriate  file*/ 
while(s  <  MAXBGS)( 

if(strcmp(BGs[i].Ships[s].Name,blank)  !=  0){ 

fprintf(DataFile,  “%s\n”,  BGs[il.Ships[s).Name); 
fprintf(DataFile.  “%s\n”,  BGs[i].Ships[sj.Hull); 
fprintf(DataFile,  “%(lvn’’, 
BGs(il.Ships[sl.TypeCombatanl); 

fiprintf(DataFile,  “%(fvn”, 
BGs[i].Ships[s].Location.Dtg); 

fprintf(DataFile,  “%.3fNn”. 
BGs[i].Ships[s].Location.Speed); 

fprintf(DataFile,  “%.3f\n”, 
BGs[i].Ships[s].Location.MaxSpeed); 

fprintf(DataFile,  ‘‘%.3lf\n”. 
BGs[i].Ships[sl.Location.Latitude); 
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fprintf(DalaFile.  “%.31f\n”, 
BGs[i].Ships(s].Location.Longitude): 

fprintf(DataFile,  “%.3lf\n”. 
BGs[i].Ships[s].Location.Course): 

fprintf(DataFile,  “%d\n”. 
BGs[i].Ships[s].F76.0nHand); 

fprintf(DataFile,  ‘‘%d\n”. 
BGs(i].Ships[s].F76.EstOnHand): 

fprintf(DataFile,  BGs[i].Ships(s].F76.Dtg); 

/♦F44Info  here;  not  implemented  yet*/ 

fprintf(DataFile.  “%dNi”,  BGs[i].Ships[s].Approach); 
fprintf(DataFile.  “%dVn'\  BGsii].Ships[s].BreakAway); 

/♦Ordinfo  here;  not  implemented  yet*/ 

/*AcftInfo  here;  not  implemented  yet*/ 

S++; 

I 

fclose(DataFile); 


4c  ifr  *  4c «  «  4c « 4t  4c  *  4c 4t  4c  *  *  *  4c  tfc  ♦  4t  4ci|i  t(c  ♦  4c *  4t  4c  *  t|c  % sft  4r  4c 

*  Get  the  F76  information  by  ship  type  from  the  ASCII  text  file  into 

*  memory. 

4c  4c  4c  4(  4c  4c  4(  4c  4t  4c  4c  4i  4c  4c  4c  4c  4i  4c  4t  4(  4c  4i  4c  4c  4c  4e  4(  4c  4c  4c  4i  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4t  4c  4c  4c  4c  4c  4c  4c  4c  4c  4t  4c  4c  4c  4i  4c 
*/ 

void  GetF76Table(Table) 

F76ShipTypeInfo  Table[MAXSHIPTYPESl; 

{ 

FILE*  DataFile; 

int  i  =  0; 


DataFile  =  fopen(F76DATA,  “r”); 


while  (!feof(DataFile))  { 

fscanf(DataFile,  '*%s”,  Table[il.ShipType); 
fscanf(DataFile.  '‘%d”.  &Table[i).F76Capacity); 
fscanffDataFile,  “%d”,  &Table[i].F76Receive); 
fscanf(DataFile,  “%d”,  &Table[i].F76Transfer); 
fscanf(DataFile,  “%r\  &Table[i].CoefI0]); 
fscanf(DataFile,  “%r,  &Table[ij.Coenii); 
fscanffDataFile, ’'%f\n”,&TabIe[i].CoefI2]); 
i++; 

I 

fclose(DataFile); 
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:(c  %  4c  4e  4c  3|c  4t  *  4(  4t  :4i «  3|c  41 4i  4t  4t  4t  ♦  4c  4c « :4( 

*  Get  the  battle  group  ships  from  the  ship  data  ASCII  text  file  and  the 

*  F76  information  by  ship  type  from  memory.  The  next  ship  index  available 

*  is  returned  as  an  integer. 

4i  4c  4c  4c  4i  4c  4c  4c  4c  *  *  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4i  4i  4i  4c  4t  4t  4t  4c  4c «  4c  4t  4i  4c  4i  4c  4i  4c  4c  *  *  4c  4i  4c  4i  4i  4i  4c  4c  4c  4c  4i  4c  4c 
*/ 

int  GetBGShips(BGs,i,  F76Table) 

BGInfo  BGs[MAXBGS]; 

int  i; 

F76ShipTypeInfo  F76Table(MAXSHIPTYPES]; 


char 

FileName[100]; 

char 

Suffix[MAXNAMEl; 

static 

char  blank[MAXNAMEl; 

FILE* 

DataFile; 

int 

s; 

int 

Index; 

s  =  0; 

/♦Based  on  BG  Index,  create  appropriate  file  name  for  BG  ships.  Ex: 
For  ships  in  BGs[0],  filename  is  /hA)glcss/scripts/data/Ships0.dat*/ 

strcpyfFileName,  BGSHIPS); 
strcpy(SuffixJntToString(i)); 
strcat(Suffix.  “.dat”); 
strcat(FileName,  Suffix); 

DataFile  =  fopen  (FileName,  “r"); 

/♦Read  in  Shipinfo  for  ships  in  this  BG  from  appropriate  file*/ 
whiled  feof(DataFile))  | 

fscanf(DataFile.  “%[A\n]\n*’.BGs[i].Ships[s].Name): 
f^scanf(DataFile,  “%s\n”.  BGs[i].Ships[s).Hull); 


Index  =  TypeShip(BGs[i].Shi|K(s].Hull); 

BGs[i].Ships[s].F76.Capacity  =F76Table[Index).F76Capacity; 
BGs[i].Ships[s].F76.ReceiveRate= 

F76Table[lndex].F76Receive; 

BGs[i].Ships[s].F76.TransferRate= 

F76Table[Index]  .F76Transfer; 


BGs[i].Ships[s].F76.Coef[01  =  F76TabIe[lndex].CoefI0] 

BGs[i].Ships[s].F76.Coef[l)  =  F76Table[Index].Coefll] 

BGs[i].Ships[sl.F76.Coefl21  =  F76Table[Indexl.CoefI2] 


fscanf(DataFile,  ‘'%dNn”. 
fscanf(DataFile,  '’%d\n”. 
fscanf(DataFile,  '‘%f\n”, 
fscanf(DataFiIe,  ‘■%f\n”. 
fscanf(DataFiIe.  “%lf'n”, 
fscanf(DataFiIe,  “%lf\n", 
fscanf(DataFile.  “%lf'n”. 


&BGs[i].Ships[s].TypeComhatant); 

&BGs[ii.Ships[sj.Locaiion.Dtg); 

&BGs(i  ].S  hips[  s]  .Location.  Speed); 

&BGs[ij.Ships[s].Location.MaxSpeed); 

&BGsIij.Ships[s].Location.Latitude); 

&BGsii].Ships[s].Location.Longih]de); 

&BGsIi].Ships[si.Location.Course); 


/♦Read  in  last  current  F76  states*/ 
fscanf(DataFile.  “%d\n”,  &BGs[il.Ships[s].F76.0nHand); 
fscanf(DataFile,  &BGs[ij.Shipsisi.F76.EstOnHand); 

fscanf(DataFile,  “%d\n”,  &BGs(ij.Ships|sj.F76.Dtg); 
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/*F44Info  here;  not  implemented  yet*/ 

fscanf(DataFile,  “%(I\n”,  &BGs(i].Ships[s].Approach); 
fscanf(DataFile,  &.BGs[ii.Ships[s].BreakAway); 

/*Or(ilnfo  here;  not  implemented  yet*/ 

/*AcftInfo  here;  not  implemented  yet*/ 

S++; 

) 

fclose(DataFile); 

retum(s); 


*  Make  a  new  battle  group,  using  information  provided  by  user  to  New  BG 

*  Panel.  The  index  for  the  next  available  battle  group  in  the  array  is 

*  returned. 

^  4c  4c  4t  ^  4c  4i  4141 4i  4t  4c  :(c  4c  4t  *  4c  4c  3|c  4t  4t  ^  4(  4c  3^  %  4t  :(i  4c  4c  *  4c  4t  4c  3(i 


int  MakeBG(BGs,i,Name,Desg,FRes,CRes,ORes,COResJ^6J'44,SSpeed. 
USpeed,  AS  Speed) 


BGInfo 

BGs[MAXBGS]; 

int 

i; 

char 

Name[MAXNAME]; 

char 

Desg[MAXNAME]; 

float 

FRes,  CRes,  ORes,  CORes, 

F76,  F44,  SSpeed,  USpeed,  ASSpeed; 

if  (Name  &&  Desg  &&  FRes  &&  CRes  &&  ORes  &&  CORes 
&&  F76  &&  F44  &&  SSpeed  &&  USpeed  «&&  ASSpeed)  { 


strcpy(BGs[i].Name,  Name); 

strcpy(BGs[ij.Designation,  Desg); 

BGs[i].Settings.FuelRes 

=  FRes; 

BGs[i].Settings.CLFFuelRes 

=  CRes; 

BGsiij.Settings.OrdRes 

=  ORes; 

BGslij.Settings.CLFOrdRes 

=  CORes; 

BGs(ij.Settings.MaxF76 

=  F76; 

BGs[i].Settings.MaxF44 

=  F44; 

BGs[i].Settings.StationSpeed 

=  SSpeed; 

BGs[i].Settings.UnrepSpeed 

=  SSpeed; 

BGs[il.Settings.AcftShipSpeed 

=  ASSpeed; 

i++; 

return  (1); 

return  (0); 
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*  Save  all  battle  groups  to  the  ASCII  text  file  containing  BG  data. 
*/ 

void  SaveBGs(BGs) 

BGInfo  BGs[MAXBGS]; 


FILE* 

int 

static  char 


DataFile; 
i  =  0; 

bIank[MAXNAME]; 


DataFile  =  fopen(BGDATA.  “w”); 

while  (i<MAXBGS)( 

if  (strcmp(BGs[i].Name,  blank)  !=  0){ 

fprintf(DataFile.”%s\n’'.  BGs[i]. 
fprintf(DataFile,”%s\n”,  BGsfij. 
fprintf(DataFile.”%.  lfNn”.BGsIi] 
fiprintf(DataFile.”%.  lf\n”,BGs[i] 
fi)rintf(DataFile,”%.  lfin”,BGs[i] 
fprintf(DataFile.”%.lfvn”,BGs[i] 
fprintf(DataFile  ”%.  lfin”.BGs[i] 
fprintf(DataFile 1  fin”.BGs[i] 
fiprintf(DataFile  ”%.  1  f'fl”,BGs[i] 
fprintf(DataFile;’%.  1  f'n”.BGs[i] 
fprintf(DataFile,”%.  1  fSn”, 
BGs(i].Settings.AcftShipSpeed); 


Name); 

Designation); 

•Settings-FuelRes); 

Settings.CLFFuelRes) ; 

■Settings.OrdRes); 

■Settings.CLFOrdRes); 

.Settings.MaxF76); 

.Settings.MaxF44); 

•Settings.StationSpeed); 

■Settings.UnrepSpeed); 


I 

fclose(DataFile); 


*  Show  list  of  battle  group  ships,  given  battle  group  index,  panel  name, 

*  and  selection  list  item  on  panel. 

*/ 

void  ShowBGShips(i,  Panel,  ItemName) 


int 

Id 

char 

{ 


i; 

Panel; 

ItemName[15]; 


char 

FILE* 

char 

TEXT* 

char 

char 

TAEINT 
static  char 

a  =  0; 


FileName[801; 

DataFile; 

Suffix[MAXNAME]; 
temp[MAXBGSJ; 
CmdfMAXNAME]; 
buffi  10]; 

^  z* 

blankIMAXNAME); 


/*Based  on  BG  Index,  get  the  appropriate  file  name  for  BG  ships.  Ex: 
For  ships  in  BGs[0],  filename  is  /h/bglcss/scripts/data/ShipsO.dat*/ 
strcpy(FileName,  BGSHIPS); 
strcpyfSuffix,  IntToString(i)); 
strcatfSuffix,  “.dat”); 
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strcat(FileName,  Suffix); 

DataFile  =  fopenfFileName,  “r”); 

while  (!feof(DataFile)){ 

fscanf(DataFile,”%[*\nI\n’',  &Cmd[0]); 
z  =  0; 

/*skip  over  data  until  reach  ship  name*/ 
for  (z  =  0;  z  <  13;  z++){ 

fscanf(DataFile”%[''\n]\n”,  &buffl0]); 

) 

temp[a]=(TEXT  *)  malloc(strlen(Cmd)+l); 

strcpy(temp[a],  Cmd); 

a++; 


fclose(DataFile); 

Wpt_SetStringConstraints(PanelJtemName.a.temp); 

} 

*  Show  battle  group  data  given  battle  group  array,  index,and  panel  name, 

4c  i|c  4i  ^  4i  4(  *  4t  *  *  4c  *  4i  4c  4t  4c 4i 4t  4t  4ii(t  4t  4c  4t  111 *  4t  4t  4t  4t  *  4c  4t  %  *  * 

*/ 


void  ShowBG(BGs,  i.  Panel) 

BGInfo  BGs[MAXBGS]; 

int  i; 

Id  Panel; 

I 

Wpt_SetString(PaneI,  “Name”.  BGs(i].Name); 

Wpt_SetString(Panel,  “Designation”.  BGsiij.Designation); 


Wpt_SetReal(Panel.  “FuelRes”. 
Wpt_SetReal(Panel.  “CLFFuelRes”. 
Wpt_SetReal(Panel.  “OrdRes”. 
Wpt_SetReal(Panel.  “CLFOrdRes”. 
Wpt_SetReal(Panel.  “MaxF76”. 
Wpt_SetReal(Panel.  “MaxF44”, 
Wpt_SetReal(Panel.  “StationSpeed”. 
Wpt_SetReal(Panel.  “UnrepSpeed”. 
Wpt_SetReal(Panel.  “AcftShipSpeed”. 


BGs[i].Settings.FuelRes); 

BGs[i].Setlings.CLFFuelRes); 

BGs[i].Settings.OrdRes); 

BGsiij.Settings.CLFOrdRes); 

BGs[i].Settings.MaxF76); 

BGs[i].Settings.MaxF44); 

BGsfij.Settings.StationSpeed); 

BGsii].Settings.UnrepSpeed); 

BGs[i].Settings.  AcftShipSpeed); 


*  Show  list  of  navy  ships  from  ASCII  text  file  to  item  in  panel. 

tim**********************************************m********** 

*/ 


void  ShowNavyShipsfPanel.  ItemName) 

Id  Panel; 

char  ItemName[I5]; 


TEXT* 

FILE* 

char 

TAEINT 


templMAXBGSl; 

DataFile; 

Cmd[MAXNAME]; 

a; 
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a  =  0; 

DataFUe  =  fopen(NAVYSHIPS.  “r”); 
while  (!feof(DataFile))i 

fscanf(DataFile,’'%[^\nISn”,  &Cmd[0]); 
lemp[a]=(TEXT  *)  malloc(strlen(Cmd)+l); 
strcpy(temp[a],  Cmd); 
a++; 

1 

Wpt_SetStringConstraints(Panel,  ItemNaine,a,temp); 
fclose(DataFile); 


^  ^  ^  4c  4c  ^  4t  4c  4t  *  %  ^  4i  4i  4e  *  4t  4t  4c  4i  4c  %  :4t 

*  Show  list  of  battle  groups  from  ASCII  text  file  to  item  in  panel. 

*/ 


void  ShowBGs(Panel,ItemName) 

Id  Panel; 

char  ItemName[15]; 


TEXT* 

FILE* 

char 

char 

TAEINT 
static  char 


temp[MAXBGS]; 

DataFUe; 

Cmd[MAXNAME]: 

buffflOI: 

a,i; 

blank[MAXNAME]; 


a  =  0: 


DataFUe  =  fopen(BGDATA,  “r”); 

while  (!feof(DataFUe))( 

fscanf(DataFile,”%['An]\n’\  &Cmd[0]); 
i  =  0; 

for  (i  =  0;  i  <  10;  i++)| 

fscanf(DataFile”%['An]\n”.  &bufflO]); 

I 

if  (strcmp(Cmd,bIank)  !=  0)| 

temp[a]=(TEXT  *)  malloc(sulen(Cmd)+l); 

strcpy(temp[a],  Cmd); 

a++; 


1 

Wpt_SetStringConstraints(Panel,  ItemName,a.  temp); 
fclose(DataFile); 
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*  Save  new  battle  group  using  Id  Target  from  user  input  panel.  First, 

*  GetBGs  is  called,  returning  the  available  index  to  the  array.  Next. 

*  Make  BG  is  called  and  then  SaveBGS  saves  all  battle  groups. 

*/ 

int  SaveNewBG(Target) 

Id  Target; 

I 

BGInfo  BGs[MAXBGS]: 
int  BGIndex; 

BGIndex  =  GetBGs(BGs); 

if  (MakeBG(BGs,BGlndex,StringlPann(Target.”Name”), 
StringParm  (Target. ’’Designation”), 

RealParm  (Target,”FuelRes”). 

RealParm  (Target,”CLFFuelRes”), 

RealParm  (Target,”OrdRes”), 

RealParm  (Targel,”CLFOrdRes”), 

RealParm  (Target,”MaxF76”). 

RealParm  (Target,”MaxF44”). 

RealParm  (Target,”StationSpeed”). 

RealParm  (Target,”UnrepSpeed”), 

RealParm  (Target,” AcftShipSpeed”)))  ( 

SaveBGs(BGs); 

retum(l): 

}  else  ( 

retum(O): 

I 


y4>«4c4i4(*«4c4c4e4c*«4c4c**4t4c4c4(4(*««4(4c«*««**4c4(«4i4c4c4c«4c4t4c4c4c4c4t«4c4c4i4c4c****4e 

*  This  function  merely  wipes  out  the  contents  of  a  battle  group  panel. 

4c*«4i4c*4(>tc«*«4>4c4c*4c«4c4(4c4c4i«4i4i4c4i4i*4c4c4c4c4c*«4>4c«4t4c4(4i4c4c4(4c4c4t4c4c4t4e4c*4r4c4c« 

*/ 

void  CancelBG(Panel) 

Id  Panel; 

I 

Wpt_SetNoValue(Panel,”Name”); 

Wpt_SetNoValue(Panel,”Designation”); 

Wpt_SetNoValue(Panel,”FuelRes”); 

Wpt_SetNoValue(Panel,”CLFFuelRes”); 

Wpt_SetNoValue(Panel,”OrdRes”); 

Wpt_SetNoValue(Panel,”CLFOrdRes”); 

Wpt_SetNoValue(Panel.”MaxF76”); 

Wpt_SetNoValue(PaneI,”MaxF44”); 

Wpt_SetNoValue(Panel,”StationSpeed”); 

Wpt_SetNoValue(Panel,”UnrepSpeed”); 

Wpt_SetNoValue(PaneI.”  AcftShipSpeed”); 

Wpt_SetNoValue(Panel,”BGShips”); 


y****4i4>*********>l<<k****:<»li**4i*<l<4>***4i4i****4i******4<***********4i** 

*  Using  the  string  representation  of  the  name  of  a  battle  group  and  the 

*  index  to  the  appropriate  battle  group  in  the  array,  return  the  index  to 

*  the  battle  group. 

V 

int  GetBG(Name,  BGIndex) 
char  NamefMAXNAME]; 

int  BGIndex; 

I 

FILE*  DataFile; 
int  i,s; 

char  Cmd[MAXNAME]; 
char  buf[MAXNAMEJ; 
int  Found; 

Found  =  0; 

i  =  0; 

DataFile  =  fopen(BGDATA,  “r”); 
while  ((!feof(DataFiIe))  &&  (Found  ==  0)){ 

fscanf(DataFile,”%(^\nISn”,  &Cmd[01); 

s  =  0; 

for  (s  =  0;  s  <  10;  s++){ 

fscanf(DataFile,”%s\n’‘,  &bufI0]); 

I 


if  (strcmp(Name,Cmd)  !=  0){ 
i-H-; 

}  else! 

Found  =  1; 


1 

fcIose(DataFile); 


if  (Found  =  0){ 

retum(BGIndex); 

)  else  { 


retum(i); 


4r  4: 4r  ifr  4r  4k  4c  4r  4r  4t  4r  J#  4r  4(  *  >|t  4r  4r  4r  4t  4c  4r  4r  4r  4r  4r  4r  4r  4c  4r  4^  4r  4t  4r 

*  This  deletes  the  battle  group  from  the  array  by  removing  its  name. 

*  The  name  is  replaced  by  blank  spaces. 

4c  4c  4  4  4c  4t  4(  4  4>  4  4c  4t  4c  4c  4c  4  4c  4r  4(  4  4  4c  4c  4  4  4  4c  4c  4c  4c  4c  4i  4c  4  4  4  4c  4c  4r  4  4c  4c  4  4  4c  4c  4c  4c  4c  4  4c  4c  4c  4r  4c  4t  4c  4r  4(  4 

*/ 

void  DeleteBG(BGs.  i) 

BGInfo  BGs[MAXBGS]; 
int  i; 

{ 

static  char  blank[MAXNAME]; 


if  (i  !=-!){ 

strcpy(BGs[i].Name,blank); 
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) 

} 

y  4t  ^  4c  *  4t  3fc  *  *  %  %  « 3|c  #  4t  *  *  3|t  ]|t  ]|i  %  4>  *  4^  4c  *  «  *  *  >t<  %  * 

*  This  function  checks  the  first  two  characters  in  a  ship’s  huU  number 
'*'  and  returns  an  integer  that  equates  to  an  enumerated  ship  type. 

i)i^:t,^,<i,m***m****A‘******’¥**************»t********************** 


int  TypeShip(String) 
char  String[40]; 

( 

int  s; 
char  Slice[40]: 

strcpy(Slice,  String); 

Slice[2]  =  0; 

if  (strcmp(Slice,  “DD”)  =  0)  1 
return  (3); 

1  else  if  (strcmpfSlice,  “AO”)  ==  0)  { 
return  (6); 

) 


y «  4c  4e  4c  3(1 4c  4i  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4i  4c  4c  4c  4c  4c  4c  4>  4t  4c  4c  4c  4>  4c  4c  4c  *  4c  4c4c  4c  4c  4t  4t  4c4c  4c  4t  4c  4c  4c  *  4c  4c  4t  4c  4c  4c  *  4t  4c  4c  4c  4c  4t  4c 

*  This  function  adds  a  ship  and  its  data  to  a  battle  group. 

*  The  ship  list  presented  to  the  user  contains  both  the  hull  number 

*  and  the  ship  name.  The  hull  number  is  r^uired  to  get  the  ship  type  for 

*  the  appropriate  F76  information.  The  ship  name  is  returned. 

4c  4c  4c  4c  4c  4i  4c  4c  4t  4c  4c  4c  4c  4c  4c  4c  4(  4c  4c  4c  4(  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4>  4c  4c  4t  4c  4c  4c  3^  4c  4c  4(  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4>  4c  4c  4t  4c  4c  4c  4c  4c 

V 


char*  AddShip  (BGs.  i,  s.  ShipString) 


BGlnfo  BGs[MAXBGS]; 
int  i.  s; 

char*  ShipString; 

I 

int 

F76ShipTypeInfo 

char* 

char* 

char* 


Index; 

F76Tablef  MAXSHIPTYPES) ; 
MySuing; 

HullString; 

NameString; 


MySiring  =  strdup(ShipString); 
HullString  =  strtok(ShipString,"  ‘’); 
NameString  =  strstr(MyString,”USS”); 


strcpy(BGs[i].Ships[s].Name,  NameString); 
strcpy(BGs[i].Ships[s].Hull,  HullString); 
Index  =  TypeShip(HullString); 
if  (Index  ==  3){ 

BGs[ii.Ships[s].TypeCombatant=  1; 

1 


IK) 


GetF76TabIe(F76Table); 

BGs[i].Ships[s].F76.Capacity 
Bf  /[i].Ships[s].F76.0nHand 
F  js[i].Ships[s].F76.EstOnHand 
LGs[i].Shjps[s].F76.Dtg 

BGs[i].Ships[s].F76.ReceiveRate 

BGs[i].Ships[s].F76.TransferRate 

BGs[i].Ships[s].F76.Coef[0] 

BGs[i].Ships[s].F76.CoefIl] 

BGs[iI.Ships[s].F76.Coef[2J 

BGs[i].Ships[s].Location.Dtg 

BGs[i].Ships[s].Location.Speed 

BGs[i].Ships[s].Locaiion.MaxSpeed 

BGs[i].Ships[s].Location,Latitude 

BGs[i].Ships[s].Location.Longitude 

retum((char*)ShipString): 


=  F76Table[lndex].F76Capacily; 
=  BGs[i].Ships[s].F76.Capacity; 
=  BGsii].Ships[sl.F76.Capacity; 
=  cuiTeni_tinie{): 

=  F76Table[lndex].F76Receive; 
=  F76Table[lndexl.F76Transfer. 

=  F76Tablenndexl.Coef[0]: 

=  F76Tableilndexl.Coef[l]; 

=  F76Table[Ir.dex].Coef[2]; 

=  ciJiTeni_timeO; 

=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 


y*************** *♦**♦♦♦♦***•*♦*»*****♦♦*•*♦ 

*  Given  the  battle  group  array,  this  function  gets  the  battle  group  data 

*  from  the  battle  group  data  ASCII  text  file.  Returns  the  next  available 

*  battle  group  index. 

t,ti*tmm****mm»*>>‘**’»'***************i***i************************^ 


*/ 


int  GetBGs(BGs) 
BGInfoBGsfMAXBGSl; 

( 

FILE*  DataFile; 
int  i  =  0; 


system  (“cp  SBGLCSS/data/BGData.dat  $BGLCSS/data/BGData.dat.bak"); 


DataFile  =  fopen(BGDATA,  ‘r’’); 


while  (!feof(DataFile))  | 

fscanf(DataFile,  *‘%(''Virn 
fscanf(DataFile,  “%[''ViI\n 
fscanf(DataFile,  "%fSn”, 
fscanf(DataFiIe,  "%f\n”. 
fscanf(DataFile,  '*%f\n”, 
fscanf(DataFile,  '‘%f\n”, 
fscanf(DataFile,  “%f\n”, 
fscanf(DataFilc.  “%f\n”. 
fscanf(DataFile,  “%f\n’'. 
fscanf(DataFile.  “%f\n”. 
fscanf(DataFiIe,  ‘■%I'n”. 
•++; 


BGs[i].Name); 
BGsIij.Designation); 
&BGs(i].Setungs.FuelRes); 
&BGs(ij.Settings.CLFFuelRes); 
&BGs[ii.Settings.C)rdRes); 
&BGsii].Settings.CLFOrdRes); 
&BGs(ii.Settings.MaxI^6); 
&BGs[i].Settings.MaxF44); 
&BGs(ij.Settings.StationSpe  d); 
&BGs[i).SetDngs.UnrepSpeed); 
&BGs{ij.Settings.AcftSiiipSpeed); 


1 

fclose(  DataFile); 
retum(i); 


/ 

^^immiim***m**^^m**m**mm*^*-^n‘**m^**mj^*m***^*******m*********^***^**  ***********  I 


Ill 
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♦  structure  definitions 

♦Note  :  “global.h”  TAE-generated  file  includes  bg.h 

^  #c  4r  4t  4c  4t  4r  4r  4r  4t  4r  4t  ^  4r  3^  4i  4i  tft  *  4t  ]ft  ♦  4r  ^  4t  4r  4t  4t  4(  4c 

♦/ 

#include  <stdio.h> 

#include  <stdlib.h> 


l**m*^m***m^im*******************tt**************^t***#***^c*****^,**********i 

enum  ThreatType  ( 

Low, 

Med, 

High, 

Raid, 

Strike, 

Asw, 

NoTlu’eat 


typedef  enum  ThreatType  ThreatType; 

|***m*******J),:>,^,^,*^L^,**:^*^L*^,^^^,^L^,^,**^,^im***********^•*********:*:*************^ 

enum  CalcType  | 

Ord, 

F76, 

F44, 

BothFuel, 

All 

I: 

typedef  enum  CalcType  CalcType; 


\ 
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enum  Targets  ize  | 
Small. 
Medium, 
Large 


typedef  enum  TargetSize  TargetSize; 


enum  StrikeType  ( 
SAiiOnly, 
SAirSurface, 
SSurfaceOnly, 
LAiiOnly, 
LAirSurface, 
LSurfaceOnly 
I; 


typedef  enum  StrikeType  StrikeType; 

y4t4(*4>%>l>%4i4i4i4i4c4i4i4i4E4E4i«4t4t%4i*4i4c4t4>4i4<4i4i4‘4c4E4'4<^#’^%>l>4i4t*^4r%4c**4i4t*>ti4t^4t4t4t)^4>4t4i*^4t*4t4i3t>y 


enum  RaidType  ( 
SNA, 
SLCM, 
TACAIR 


typedef  enum  RaidType  RaidType; 

y******«*«***«4>*4<  ***«****••*****«**  *********4")'*******  *************  ******y 

enum  TacticType  ( 

ServiceStation, 

Delivery  Boy, 

Circuitl^der. 

Vertrep 


typedef  enum  TacticType  TacticType; 

y*4>4i**4‘4>4i*<«i4>4i*4i«4i*4i4(*«*4<4i4i*4i***>»c4>4i*4>*««*****4t***«>tt**«***«4r«****4r*****4t4i4t^ 

typedef  struct  | 

OrdName  Name; 

int  Quantity: 

lOrdAmounts; 


typedef  struct  | 

int  NumberofWepaons; 

Ord  Amounts  WeaponsUselMAXORD); 

1  RaidOrd; 


/ 
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/* 

typedef  struct  ( 
int 


TacticType 

double 


lUnrepInfo; 


DelShip, 

RecShipl. 

RecShipl; 

Tactic; 

Latitude, 

Longitude; 


7 


typedef  struct  | 

int  Shipinvolved; 

double  Course; 

double  Speed; 

IDirectionlnfo; 


^  :4i  %  4t  4t  %  3^  / 


typedef  struct  | 
int 
int 

TargetSize 

StrikeType 

double 

OrdAmounts 

IStrikelnfo; 


Shipinvolved; 

TotalNumber, 

Size; 

AttackProfile; 

Latitude, 

Longitude; 

StrikeOrdUse[MAXORD]; 


typedef  struct  { 

RaidType 

int 


int 

RaidOrd 


IRaidInfo; 


AttackProfile; 

Size, 

Threat  Axis, 

NumberofShips; 

ShipsInvolvedfMAXSHIPSJ; 

ShipUse[MAXSHIPSl; 


4t4i4i4ii|i%*4t«  *******  «*****«/ 


typedef  struct  { 

int  Shipinvolved; 

OrdAmounts  WeaponsData[MAXORDj; 

lASWlnfo; 


typedef  struct  | 

OrdName  Name[MAXORDJ; 

int  Range[MAXORD); 

IWeaponRangeInfo; 
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enum  BGEventType  { 

BGCourseSpeed, 

ASWLevel, 

AAWLevel, 

SetStation. 

ShipCourseSpeed, 

Unrep, 

Consol, 

FuelTransfer, 

OrdTransfer, 

RaidEvent, 

StrikeEvent, 

ASWProsecute, 

ResumeBGCourseSpeed, 

Other 

I; 

typedef  enum  BGEventType  BGEventType; 


enum  PredictType  { 
Orphan, 
Child, 
Parent, 
Interval 


typedef  enum  PredictType  PredictType; 

^i|r  4r  4t  4r  4r  4r  Iff  4r  ^  4r  4r  ](( 4t  4r  4t  4t  4(  4t  4r  *  4(  4t  *  111  *  %  *  4t  4t  4c  4t  *  4>  4t  *  *  4c  ^  4>  *  4<  4t  4<  %  4)  4i  *  4>  ^  ^  y 

typedef  struct  ( 

float  F76PercentCap(3], 

F44PercentCap[3j; 

IPercentCapInfo; 

l^,^,:ti,i,mm*****************************m*************m*************»m*******m**l 

typedef  struct  | 

PercentCapInfo  Ships[MAXBGSHIPS]; 

}BGResultlnfo; 


struct  BGHeader{ 

struct  BGHeader 

BGEventType 
int 
int 
char 
char 
float 
float 

(; 

typedef  struct  BGHeader  BGHEADER; 


*Prev, 

*Next; 

EType; 

Index; 

DTG; 

Date[DTGLENGTm; 

Title[MAXLENGTH]; 

Course: 

Speed; 
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y  4(  4t  4t  4c  4(  4t  ^  4c  4c  %  4(  4t  4c  %  4i  3k  %  4i  4c  ^  4(  4t  4c  4i  4(  *  4(  ^  4(  4c  4(  *  ^ 


struct  BGEvent  | 


struct  BGEvent 

’"Prev, 

*Next; 

int 

DTG, 

Index, 

Created. 

Predictlnterval; 

BGEventType 

EType; 

PredictTypie 

PType; 

CalcType 

CType; 

ThreatType 

TType; 

Unrepinfo 

Unrep; 

Directioninfo 

Direction; 

Strikeinfo 

Strike; 

Raidinfo 

Raid; 

ASWlnfo 

ASW; 

typedef  struct  BGEvent  BGEVENT: 


/4e4c4i4c4c4c4c4c4c4c4c4c4c4c4c4c4c4t4c4c4c4c4c4c4c4c4c4c4c4i4i4 


struct  RelationType  { 


struct  RelationType 

*Prev, 

*Next; 

int 

Created; 

BGEVENT 

*Childl, 

*Child2. 

*Child3. 

*Child4, 

•Child5; 

typedef  struct  RelationType  RELATION; 

^*4e  4c  4c  4c  4c  4c  4c  4c  4t  4c  4c  4c  4c  4c  4c  4c  4>  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c4i4<  4c  4c  4c  4c  4t  4c  4c  4c  4c  3k  4c  4c  4C4C4C  4c  4c  4t  4c  4c  4c  4c  4c  4c  4c4c  4c  4C  4c  4c  4c  4c  4c  4c  4c  4c  4C4c^ 
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♦Date  27  Feb  93 

♦Content  Bodies  of  user-defined  functions  to  represent  battle 

♦  groups  and  ships.  C  manifests  contained  in  BGEventsLib.h 

♦Note  “global.h”  TAE-generated  file  includes  bg.h 

♦/ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

/♦TAE  system  include  files*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “symtab.inc” 

#include  “parblk.inc” 

#include  “terminc.inc” 

#include  “global.h” 

#define  YES  I 

#define  NO  0 

♦  This  function  saves  the  battle  group  events  list  given  an  index  to  the 

♦  appropriate  batde  group  in  the  array  and  a  pointer  to  the  head  of  the 

♦  batde  group  event  list.  It  returns  the  pointer  to  the  head  of  the 

♦  list. 

♦/ 

BGEVENT*  SaveBGEvents(BGIndex,  BGEventList) 
int  BGIndex; 

BGEVENT*  BGEventList; 


char  FileName[100]; 

char  Suffix[MAXNAME]; 

FILE*  DataFile; 

BGEVENT*  Cunrent;  /♦pointer  used  to  traverse  the  doubly-linked  list*/ 

/♦Based  on  BG  Index,  create  appropriate  file  name  for  BG  events.  Ex; 

For  events  in  BGs[0],  filename  is/h/bglcss/scripts/data/EventsO.dat*/ 

strcpy(FileName,  EVENTS  DATA); 
strcpy(Suffix.IntToString(BGlndex)); 
strcat(Suffix,  “.dat”); 
strcat(FileName,  Suffix); 
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DataFile  =  fopen  (FileNatne,  “w”); 


Current  =  BGEventList; 

/^assign  the  head  pointer  to  Current  to  save  the  original  position  of  the 

head  pointer*/ 

while  (Current  !=  NULL)! 

f^ntf(DataFile,  “%(Kn”,  Current->DTG): 
fprintf(DataFile,  “%dvn”,  Current->Created); 
f^ntf(DataFile,  “%d\n”,  Current->EType); 
fprintf(DataFile,  “%dvn”,  Current->CTj^); 
fi)rintf(DataFile,  “%(fvn”,  CuiTent->TType); 
if  (Cunent->EType  ==  BGCourseSpeed)! 

fprintf(DataFile,  “%lf\n”,  Current->Direction.Course); 
fprintf(DataFile,  “%ll\n”,  Current->Direction. Speed); 

I 

if  (Cunent->EType  =  Unrep){ 

fprintf(Dat^ile,”%dSn”.  Current->Unrep.E)elShip) ; 
fprintf(DataFile,”%d\n”.  Current->Unrep.RecShipl); 
fprintf(DataFile  ”%<f>n”,Cuirent->Unrep.RecShip2); 
fprintf(DataFile”%d\n”,  Current->Unrep.Tactic); 
f])rintf(DataFile,”%lfNn”,  Current->Unrep.Latitude); 
fprintf(DataFile.”%lfvi”,  Current->Unrep.Longitude); 
fprintf(DataFile,”%d\n”,  Curre.nt'>Direction.ShipInvolved): 
fprintf(DataFile,”%lfSn”,Current->Direction.Course); 
fprintf(DataFile,”%lf«”,CurTent->Direction.Speed); 

I 

Current  =  Current->Next; 

I 

fclose(DataFile): 

retum(BGEventList): 


y«**4<4i«itc4>***«4i«4i««««*4iiti4>*«**i«i***««4<***«4>**********:4t«***4i**4i* 

*  This  function  reads  the  battle  group  event  list  data  from  the  appropri- 

*  ate  ASCII  text  file  given  the  index  to  the  battle  group  array.  It 

*  returns  a  pointer  to  the  head  of  the  bathe  group  event  list. 

4t  4t  4i  *  4c  4t  *  *  4t  4c  *  *  4t  4k  4c  4t  4i  4(  4t  %  ♦  4c  4c  *  4c  4r  4r  4t  4c  *  9|( «  «  9^  *  *  *  4t  4c  *  :4i  % 

V 


BGEVENT*  GetBGEvents(BGIndex) 
int  BGlndex; 


char 

char 

FILE* 

BGEVENT* 

BGEVENT* 

BGEVENT* 


FileName[100]; 

SuffixfMAXNAMEJ; 

DataFile; 

Current; 

Head  =  NULL; 

Temp; 


/*aUocate  memory  for  the  Head  event  struct*/ 

Head  =  (BGEVENT*  )  malloc(sizeof  (struct  BGEvent )); 


/*make  sure  these  data  are  correctly  initialized*/ 
Head->Next  =  NULL; 

Head->Prev  =  NULL; 

Head->DTG  =  0; 


/*Based  on  BG  Index,  create  appropriate  file  name  for  BG  events.  Ex; 
For  events  in  BGs(0],  filename  is  /h/bgIcss/scripts/data/EventsO.dat*/ 


Ilg 


strcpy(FileNaine,  EVENTSDATA); 
strcpy(Suffix,IntToString(BGIndex)); 
strcat(Suffix,  “.dat"); 
strcat(FileName,  Suffix); 

if  ((DataFile  =  fopen  (FileName,  “r”))  !=  NULL)i 

/*get  the  Head  data  first*/ 
fscanf(DataFile,  &Head->DTG): 

fscanf(DataFile.  “%dNii”,  &Head->Created); 
fscanf(DataFile,  “%dSn”,  &Head->EType); 
fscanf(DataFile,  “%dNn”,  &Head->CTypc); 
fscanf(DataFile.  &Head->TType); 

if  (!feof(DataFile))( 

if  (Head->EType  =  BGCourseSpeed)| 

fscanf(DataFile,  “%lf'ai”,  &Head->Direction.Course); 
fscanf(DataFile,  “%lfSn”.  &Head->Direction.Speed): 

1 

if  (Head->EType  =  Urirep){ 

fscanf(DataFile,”%crvn”,&Head->Unrep.DelShip); 
fscanf(DataFile,'*%<Ni”,  &Head->Unrep.RecShipl ); 
fscanf(DataFile.”%<Ni”.  &Head->Unrep.RecShip2); 
fscanf(DataFile,"%(Ni”,  &Head->LJnrep.Tactic); 
fscanf(DataFile,”%U\ii”,&Head->Unrep.Latitude); 
fscanf(DataFile,”%U\n”,&Head->Unrep.Longitude); 
fscanf(DataFile.”%(fsn”.&Head->Direction.ShipInvolved): 
fscanf(DataFiIe.”%lf\n”,&Head->Direction.Course); 
fscanf(DataFile,”%U\n”.&Head->Direction.Speed); 

} 

/‘other  event  cases  to  be  implemented*/ 

I 


/*assign  Head  to  Current  to  save  original  Head  pointer  position*/ 

Current  =  Head: 

while  (!feof(DataFile)){ 

/‘make  a  new  event  node  for  each  new  data  read*/ 

Temp  =  (BGEVENT*  )  mallocfsizeof  (struct  BGEvent )); 

Temp->Next  =  NULL; 

/‘attach  new  node  to  Current*/ 

Temp->Prev  =  Current; 

Current->Next  =  Temp; 

/‘move  to  the  new  node*/ 

Current  =  Current->Next; 

fscanf(DataFile,  &CuiTent->DTG); 

fscanf(DataFile,  ''%dNn”,  &Current->Created); 
fscanf(DataFiie,  ‘'%d\n”,  &CuiTent->EType); 
fscanf(DataFile,  ‘*%d\n”.  &Current->CType); 
fscanf(DataFile,  “%d\n”.  &Current->TType); 
if  (!feof(DataFile)){ 

if  (Current->EType  =  BGCourseSpeed){ 

fscanf(DataFiIe.”%lfNn”.&Current->Direction.Course); 

fscanf(DataFile,”%lf\n”,&Current->Direction.Speed); 

1 

if  (CuiTent->EType  =  Unrep)  ( 

fscanf(DataFile,”%d\n’’.  &CuiTent->Unrep.DelShip); 
fscanf(DataFile,"%d\n”,  &Current->Unrep.RecShipl); 
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fscanf(DataFile,”%dSn”,  &Current->Unrep.RecShip2); 
fscanf(DataFile.”%d\n”,  &Current->Unrep.Tactic): 
fscanf(DataFile,”%lf\n”,  &CiiiTent->Unrep.Latitude); 
fscanf(DataFile,”%lfSn”,  &Current->Unrep.Longitude); 
fscanf(DataFile,”%d^”, 

&Current->Direction.ShipInvolved); 

fscanf(DataFile,’’%lfNn”,&Current->Direction.Course); 

fscanf(DataFile,”%lfvn”,&Current->Direction.Speed); 

I 

/♦other  event  cases  to  be  implemented*/ 


) 

fclose(DataFile); 


retiim(Head); 

1 


l**>it*mMt^c*im*******mm*****m********************************** 

*  Given  a  pointer  to  the  newly  nade  event  node  and  values  passed  from 

*  the  Unrep  panel,  return  a  completed  unrep  event  node  to  be  added  to 

*  the  event  list.  Alter  calling  this  function,  it  is  necessary  to  make 

*  the  following  calls  to  these  functions  (yet  to  be  implemented): 

*  GetRelations, 

*  MakeRelation, 

*  InsertRelation, 

*  UnrepCalculations, 

*  MakeChild, 

*  InsertBGEvent, 

*  SaveRelations, 

*  SaveBGEvents. 

4t  4(  *  4c  4c  ift  «  4t  4c  iti  4c  4(  3|t  4t  4t  4t  3|i  4t  >4t 

V 

BGEVENT*  MakeUnrep(BGEvent,  Delivery,  Reel,  Rec2,  Tactic,  Lat,  Long) 
BGEVENT*  BGEvent; 


int  Delivery,  Rec  1 ,  Rec2,  Tactic; 

double  Lat,  Long; 

if  (BGEvent->EType  =  5)| 

BGEvent->Unrep.DelShip 

=  Delivery; 

BGEvent->Unrep.RecShip  1 

=  Reel; 

BGEvent->Unrep.RecShip2 

=  Rec2; 

BGEvent->Unrep.Tactic 

=  Tactic; 

BGEvent->U  nrep.Latitude 

=  Lat; 

BGEvent->Unrep,Longitude 

}  else  { 

=  Long; 

} 

retumfBGEvent); 
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H,rl,******mii*m*****’>i*i>‘*******************’********’l‘********** 

*  This  function  creates  the  header  to  be  displayed  in  the  event  list 

*  panel  to  the  user.  Given  the  event  parameters,  return  a  header  node. 

*/ 

BGHEADER*  MakeBGHeader(EventType.  EventTime,  EventCourse,  EventSpeed) 

/•Function  is  incomplete.  It  is  designed  to  handle  past  of  the  battle  course  and 
speed  change  event.  Need  to  add  remaining  parameters  to  make  function 
generic  to  ^1  events.*/ 

BGEventType  EventType; 

char  EventTime[DTGLENGTH]; 

float  EventCourse; 

float  EventSpeed; 

{ 

BGHEADER*BGHeader; 

BGHeader  =  (BGHEADER*  )  mallocfsizeof  (struct  BGHeader )); 

BGHeader->Prev  =  NULL; 

BGHeader->Next  =  NULL; 

if  (EventType  =  BGCourseSpeed){ 

strcpy(BGHeader->Date,  EventTime); 
strcpy(BGHeader->Title,  “BG  course  to”); 

BGHeader->Course  =  EventCourse; 

BGHeader->Speed  =  EventSpeed; 

BGHeader->EType  =  EventType; 

1 

/♦other  events  to  be  implemented*/ 
retum(BGHeader); 

) 

*  Given  the  appropriate  index  to  the  battle  group  array,  this  function 

*  gets  the  battle  group  header  information  from  the  apprt^riate  ASCII 

*  text  file  and  returns  a  pointer  to  the  head  of  the  battle  group  header 

*  list.  Similar  in  algorithm  to  GetBGEvents. 

*/ 

BGHEADER*  GetBGHeaders(BGIndex) 
int  BGIndex; 

i  =  0; 

DataFile; 

Suffix[MAXN/iiME]; 

FileName[100]; 

Current; 

Head  =  NULL; 

Temp; 

=  (BGHEADER*  )  malIoc(sizeof  (struct  BGHeader  )); 
=  NULL; 

=  NULL; 

=  0; 


int 

FILE* 

char 

char 

BGHEADER* 

BGHEADER* 

BGHEADER* 

Head 

Head->Next 

Head->Prev 

Head->DTG 
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/♦Based  on  BG  Index,  create  appropriate  file  name  for  BG  events.  Ex: 
For  events  in  BGs[0].  filename  is  /h/bgIcss/scripts/data/EventsO.dat*/ 


strcpy(FileName,  HEADERSDATA); 
strcpy(Suffix,IntToString(BGIndex)): 
strcat(Suffix,  “.dat”); 
strcat(FileName,  Suffix); 

if  ((DataFile  =  fopen  (FileName,  “r”))  !=  NULL)| 
Head->Index  =  i; 

fscanf(DataFile,  “%dSn”,  &Head->EType); 
fscanf(DataFile,  “%(fvi”,  &Head->DTG); 
fscanf(DataFile.  “%s\n”,  Head->Date); 
fscanf(DataFile,  “%s\n”,  Head->Title); 
if  (Head->EType  =  BGCourseSpeed){ 

fscanf(DataFile,”lf\n”,  &Head->Course); 
fscanf(DataFile,”lfsn”,  &Head->Speed); 

} 


/♦other  events  to  be  implemented^/ 

Current  =  Head; 
while  (!feof(DataFile))( 

Temp  =  (BGHEADER^  )  mallocfsizeof  (struct  BGHeader )); 
Temp->Next  =  NULL; 

Temp->Prev  =  Current; 

CuiTent->Next  =  Temp; 

Current  =  Ctiirent->Next; 

fscanf(DataFile,  “%d\n”.  &Head->EType); 
fscanf(DataFiIe,  &CunBnt->DTG); 

fscanf(DataFile,  '‘%sNn”,  Current->Daie); 
fscanf(DataFile,  “%s\n”,  Cunent->Title); 

if(Cunent->EType==  BGCourseSpeed)i 

fscanf(DataFile,”If\n”,  &Current->Course); 
fscanf(DataFile,”lfn”.  &Current->Speed); 

1 


/♦other  events  to  be  implemented^/ 

1 

fclose(DataFile); 

I 

retum(Head); 
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I**mnt******^i******m****^i*m*******’n****itm*******iii*******^*^**** 

*  This  function  inserts  the  newly  created  BGHeader  into  the  Header  list 

*  given  a  pointer  to  the  head  of  the  header  list  and  a  pointer  to  the 

*  newly  created  BGHeader.  It  returns  a  pointer  to  the  head  of  the  header 

*  list. 

**4>*4>***«***«*<|i**4<**4i*iti*4<*****4i*>|i«4<«****4>4»k****««*<l<********** 

*1 


BGHEADER*  InsertBGHeader(Head,  BGHeader) 

BGHEADER*  Head; 

BGHEADER*  BGHeader; 

I 

int  SpotFound; 

BGHEADER*  Current; 

SpotFound  =  NO; 

Current  =  Head; 

if(Head->DTG  =  0)  | 

Head  =  BGHeader; 

)  else  if  ((BGHeader->DTG  >  Current->DTG) 

&&  (CuiTent->Next  =  NULL)){ 

Current->Next  =  BGHeader; 

BGHeader->Prev  =  Current; 

I  else  if  ((BGHeader->DTG  >  Current->DTG)  &&  (Cuirent->Next  !=  NULL))! 

while  ((Current->Next  !=  NULL)  &&  (SpotFound  ==  NO))  | 

if  (BGHeader->DTG  <=  Current->DTG)  ( 

SpotFound  =  YES; 

)  else  ( 

Current  =  Current->Next; 

} 


if  (Current->Next  =  NULL  &&  BGHeader->DTG  >=  Current->DTG)i 
Current->Next  =  BGHeader; 

BGHeader->Prev  =  Current; 

}  else  ( 

BGHeader->Next  =  Current; 

BGHeader->Prev  =  Current->Prev; 

Current->Prev  =  BGHeader; 

BGHeader->Prev->Next  =  BGHeader; 

I 


}  else  if  (BGHeader->DTG  <=  CuiTent->DTG)  | 
Current->Prev  =  BGHeader, 
BGHeader->Next  =  Current; 

Head  =  BGHeader; 


return  (Head); 
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*  Given  an  index  to  the  battle  group  array  and  a  pointer  to  head  of 

*  the  battle  group  header  list,  this  function  saves  the  header  list  data 

*  to  the  appropriate  ASCII  text  file.  Returns  a  pointer  to  the  head  of 

*  the  header  list. 

*/ 


BGHEADER*  SaveBGHeadersfBGIndex.  BGHeaderList) 
int  BGlndex; 

BGHEADER*  BGHeaderList; 

I 


char  FileNameflOO]; 

char  Suffix[MAXNAME]: 

FILE*  DataFile; 

BGHEADER*  Current; 


/*Based  on  BG  Index,  create  appropriate  file  name  for  BG  events.  Ex; 
For  events  in  BGsfO],  filename  is  /h/bglcss/scripts/data/EventsO.dat*/ 

strcpyfFileName,  HEADERSDATA); 

strcpy(Suffix,lntToString(BGIndex)); 

strcatfSuffix,  “.dat”); 


strcatfFileName,  Suffix); 

DataFile  =  fopen  (FileName,  “w”); 
Currents  BGHeaderList; 


while  (Cunent  i=  NULL)( 

fprintf(DataFile,  “%d\n”,  Current->EType); 
fprintf(DataFile,  Current->DTG); 

fprintf(DataFile,  “%s\n”,  Current->Date); 
fprintf(DataFile,  “%s\n”,  Current->Title); 

if  (Current->EType  =  BGCourseSpeed)i 

fprintf(DataFiIe,”%lf'fl”.  CuTrent->Course); 
fprintf(DataFile,”%lfin”,  Current->Speed); 

I 


/*other  events  to  be  implemented*/ 
Current  =  Current->Next; 


fclose(DataFile); 

retum(BGHeaderList); 
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4r «  *  *  4r  *  >ft  4t  4t  4c  4r  jfr  4n|n|r  4r  J|t  4r  4r  4t  Jf(  Jfc  jfnic « ifr  4!  >|(  4c  *  4t  4r  4r  4r  4t  * 

Given  the  information  from  an  event  panel,  this  function  makesa  battle 

*  event  node  and  returns  a  pointer  to  it.  This  function  is  currently 

*  designed  to  handle  only  a  battle  group  course  and  speed  change  event. 

*  It  needs  to  be  extended  to  handle  the  remaining  events. 

4(4c«4t4i4c4c**4c4(4c4i4(4c4c4c4K**4i4(3^4c4t4t4c4t4i4c4(4c4>c^i^««*«4t«4(4c4t««4(4c4(4t4i«4(4c4c4c4c«4t 

*/ 


BGEVENT*  MakeBGEvent(EventCreated. 

EventCalc, 

EventCourse, 


EventDTG.  EventType. 

EventThreat. 

EventSpeed) 


EventPredictT  ype, 
EventShip, 


int 


EventCreated, 

EventDTG, 


BGEventType 

PredictType 

CalcType 

ThreatType 

float 

float 

{ 


EventShip; 

EventType: 

EventPredictType; 

EventCalc; 

EventThreat; 

EventCourse; 

EventSpeed; 


BGEVENT*  BGEvent; 


BGEvent  =  (BGEVENT*  )  malloc(sizeof  (struct  BGEvent )); 


BGEvent->Created 

BGEvent->Prev 

BGEvent->Next 

BGEvent->DTG 

BGEvent->EType 

BGEvent->PType 

BGEvent->CType 

BGEvent->TType 


=  EventCreated; 

=  NULL; 

=  NULL; 

=  EventDTG; 

=  EventType; 

=  EventPredictType; 
=  EventCalc; 

=  EventThreat: 


if  (BGEvent->EType  =  BGCourseSpeed)! 

BGEvent->Direction.Course  =  EventCourse: 
BGEvent->Direction.Speed  =  EventSpeed; 

} 


/*other  events  to  be  implmented*/ 
re'um  (BGEvent); 
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*  This  functions  makes  a  related-event  node  used  to  connect  related 

*  events  together  such  as  as  unrep  with  its  r»^sociated  stationing  events. 

*  The  parameter  passed  is  the  integer  value  of  the  creation  time  for  the 

*  parent  event  (such  as  the  unrep  event).  No  more  than  5  associated 

*  events  are  allowed  by  this  function.  Returns  a  pointer  to  the  newly 

*  created  relation  node. 

*  4t «  4t  4i  3|c  4i  4i  4i  4c  41 4t  4i «  4i  *  *  *  4t  *  4i  *  4t  4t  4t  4i  4t «  4i «  *  4r  ♦  )|(  4t  %  9|i  4c 

*/ 


RELATION*  MakeRe!ation(RelationCreated) 
int  RelationCreated; 

1 

RELATION*  Relation; 


Relation  =  (RELATION*  )  maIloc(sizeof  (struct  RelationType  )): 


ReIation->Created 

ReIation->Prev 

ReIation->Next 

Relation->Childl 

Relation->Child2 

ReIai!on->ChiId3 

ReIation->ChiId4 

ReIation->ChiId5 


=  RelationCreated; 
=  MJLL; 

=  NULL; 

=  NITLL; 

=  NULL; 

=  NULL; 

=  NULL; 

=  NULL; 


return  (Relation); 


*  This  function  makes  a  child  event  by  first  calling  MakeBGEvent  and 

*  attaching  the  child  to  the  appropriate  relation  node.  After  a  call 

*  to  this  function  is  made,  need  to  call,  for  instance,  UnrepCalculations 

*  and  make  the  appropriate  assignments  to  the  event  node.  Function 

*  returns  a  pointer  to  the  newly  made  child. 

«*«4>*«*4>4i**4i**«*****4>***********44c4i**«>|i****i|i***<«******«**4>* 


*/ 


BGEVENT*  MakeChild(Relation,  ParentCreationTime) 

RELATION*  Relation; 

int  ParentCreationTime; 

( 

BGEVENT*  Child; 

int  Now; 

/*now  should  be  assigned  the  intk-ger  value  of  current  system  time*/ 
Child  =  MakeBGEvent 

(NowParentCreationTime,Other,Child>IoThreat.l(X),0.0,0.0); 

if  (Relation->ChiIdl  ==  NULL)  ( 

Relation->Childl  =  Child; 

)  else  if  (Relation->Child2  =  NULL)  { 

Relation->Child2  -  Child; 

I  el.se  if  (Relation->Child3  =  NULL)  { 

Relation->Child3  =  Child; 

1  else  if  (Relation->Child4  =  NULL)  | 

Relation->Child4  =  Child; 


126 


)  else  if  (Relation->Child5  =  NULL)  j 
Relation->Child5  =  Child; 

} 

return  (Child); 


H,*il,^,^,4t**m******’»t*m***************************************** 

*  This  function  takes  a  pointer  to  the  head  of  the  battle  group  event 

*  list  and  a  pointer  to  the  newly  created  battle  group  event  and  inserts 

*  the  new  event  into  the  list  based  on  chronological  dat  time  group  of 

*  the  events.  Returns  a  pointer  to  the  head  of  the  batlle  group  event 

*  list. 

*/ 

BGEVENT*  InsertBGEvent(Head,  BGEvent) 

BGEVENT*  Head; 

BGEVENT*  BGEvent; 

1 

int  SpotFound; 

BGEVENT*  Current; 

SpotFound  =  NO; 

Current  =  Head; 

if(Head->DTG==  0)  ( 

Head  =  BGEvent; 

I  else  if  ((BGEvent->DTG  >  Current->DTG) 

&&  (CuiTent->Next  ==  NULL))  | 

Current->Next  =  BGEvent; 

BGEvent->Prev  =  Current; 

I  else  if  ((BGEvent->DTG  >  Current->DTG) 

&&  (Current->Next  !=  NULL))  | 

while  ({Current->Next  !=  NULL)  &&  (SpotFound  ==  NO))  | 

if  (BGEvent->DTG  <=  Current->DTG)  i 
SpotFound  =  YES; 

I  else  { 

Current  =  CurTent->Next; 

1 

I 

if  (CuiTent->Next  =  NULL 
&&  BGEvent->DTG  >=  Current->DTG)  | 

Current->Next  =  BGEvent; 

BGEvent->Prev  =  Current; 

I  else  I 

BGEvent'>Next  =  Current; 

BGEvent->Prev  =  CuiTent->Prev; 

Current->Prev  =  BGEvent; 

BGEvent->Prev->Next  =  BGEvent; 


I  else  if  (BGEvent->DTG  <=  Current->DTG)  1 
CurTCnt->Prev  =  BGEvent; 

BGEvent->Next  =  Current; 
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} 


Head 


=  BGEvent; 


/*  if  BGEvent  is  actually  an  interval  node,  copy  course  and  speed 
*  from  Prev  */ 

if  ((BGEvent->EType  =  Other)  &&  (BGEvent->Prev  !=  NULL))  { 

BGEvent->Direction.Course  =  BGEvent->Prev->Direction.Course; 
BGEvent->Direction.Speed  =  BGEvent->Prev->Directioit.Speed; 

1 

return  (Head); 

) 

^:«i4>*««*>)>****4'4<*>K****«4"l<*******>l<4<*****«***«*4>**«***4i«*****iti**4<>|t 

*  This  function’s  basic  algorithm  is  virutally  the  same  to  InseitBGEvent 

*  except  for  the  final  if-statement  assignments  and  the  data  type 

*  involved. 

*/ 

RELATION*  InsertRelation(Head,  Relation) 

RELATION*  Head; 

RELATION*  Relation; 

I 

int  SpotFound; 

RELATION*  Current; 

SpotFound  =  NO; 

Current  =  Head; 

if  (Head  ==  NULL)  { 

Head  =  Relation; 

I  else  if((Relaiion->Created  >  CurTent->Created) 

&&  (Current->Next  ==  NULL))  ( 

CuiTent->Next  =  Relation; 

Relation->Prev  =  Current; 

I  else  if  ((Relation->Created  >  Current->Created) 

&&  (Current->Next  !=  NULL))  ( 

while  ((Current->Next  !=  NULL)  &&  (SpotFound  ==  NO))  i 
if  (Relation->Created  <=  Current->Created)  ( 

SpotFound  =  YES; 

)  else  I 

Current  =  CuTrent->Next; 

1 

I 

if  (Current->Next  =  NULL  &&  Relation->Created  >= 
Current->Created)  | 

Current->Next  =  Relation; 

Relation->Prev  =  Current; 

}  else  ( 

Relation->Next  =  Current; 

Relation->Prev  =  Current->Prev; 

CurTent->Prev  =  Relation; 

Relation->Prev->Next  =  Relation; 

I 

I  else  if  (Relation->Created  <=  Cunent->Created)  | 

Cunent->Prev  =  Relation; 
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Relation->Next 

Head 


=  Current; 
=  Relatioii: 


} 

return  (Head); 


y  %  %  %  4c  4c «  *  4i  4c  4t  4i  *  t((  4c  4c  ift  i|t  4r 


This  functions  finds  the  Parent  event  with  its  unique  time  stamp.  If 

*  If  the  parent  doesn't  exist,  then  it  finds  the  orphan  event  and  returns 

*  a  pointer  to  the  event  found. 

4c  4c  *  4c  4c  4c  4c  4i  4c  ♦  4c  4c  4c  4c  4i  4c  4t  4c  4c  4c  4c  4t  4c  4c  4t  4c  4e  4c  4(  4c  4c  4c  4c  4t  4c  4c  4t  4t  4c  4c  4c «  4c  4c  4t  4t  4t  4t  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c 


*/ 


BGEVENT*  GetParent(Head,  Creation) 
BGEVENT*  Head; 

int  Creation; 

I 

BGEVENT*  Current; 

BGEVENT*  OrphanEvent; 

int  SpotFound; 


SpotFound 

C^hanEvent 

Current 


=  NO; 

=  NULL; 
=  Head; 


/*  if  Head  of  list  is  orphan  and  there  are  events  to  scan  */ 
if  (Current->Next  !=  NULL)  { 

while  ((Current->Next  !=  NULL)  &&  (SpotFound  == 
NO)){ 


if  (CurTent->Created  !=  Creation)  ( 

Current  =  CurTent->Next; 

)  else  if  ((Current->Created  =  Creation)  && 
(CuiTent->EType  ==  2))  ( 

Current  =  CuiTent->Next; 

I  else  { 

SpotFound  =  'YES; 

} 

I 


return  (Current); 

I  else  if  (CuiTent->Next  ==  NULL)  { 
return  (Current); 


else  if  (Current  ==  NULL)  ( 
return  (OrphanEvent); 


*  This  functions  finds  the  Parent  event  with  its  unique  time  stamp.  If 

*  If  the  parent  doesn’t  exist,  then  it  finds  the  orphan  event  and  returns 

*  a  pointer  to  the  event  found. 

4c  4i  4c  4c  4c  4c  4i  4c  4t  4t  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4i  4c  4c  4c  4c  4i  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c  4c 


*/ 


RELATION*  GetRelation(Head,  Creation) 
RELATION*  Head; 

int  Creation; 
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1 


RELATION* 

RELATION* 

int 


Current; 

OrphanEveni; 

SpotFound; 


OiphanEvent 

Current 

SpotFound 


=  NULL; 
=  Head; 

=  NO; 


/*  if  Head  of  list  is  orphan  and  there  are  events  to  scan  */ 
if  (Current->Next  !=  NULL)  { 

while  ((Current->Next  !=  NULL)  &&  (SpotFound  ==  NO))  { 
if  (CiiiTent->Created  !=  Creation)  ( 


1  else  I 

} 


Current  =  CuiTent->Next; 
SpotFound  =  YES; 


I 


return  (Current); 

}  else  if  (Current->Next  ==  NULL)  { 
return  (Current); 

)  else  if  (Current  ==  NULL)  { 
return  (OrphanEvent); 

I 


*  Given  a  pointer  to  the  head  of  the  battle  group  event  list  and  the 

*  event  to  be  deleted,  this  function  deletes  the  event.  Before  calling 

*  this  function  with  the  Parent  Event  node  pointer,  need  to  call 

*  the  DeleteChildren  function  to  delete  the  associated  children. 


4c  4(i|i  4e  «  4i  tft  4k  ♦♦  4t  4t  *  4i  4i  4t  ♦  4t  tfi  * 


*/ 


BGEVENT  *DeleteBGEvent(Head,  BGEvent) 

BGEVENT  *Head; 

BGEVENT  *BGEvent; 

I 

/*  delete  tail  */ 

if  ((BGEvent->Next  ==  NULL)  &&  (BGEvent->Prev  !=  NULL))  { 
BGEvent->Prev->Next  =  NULL; 

BGEvent->Prev  =  NULL; 

BGEvent->Next  =  NULL; 


/*  delete  Head  */ 

I  else  if  ((BGEvent->E*rev  ==  NULL)  &&  (BGEvent->Next  !=  NULL))  ( 
Head  =  BGEvent->Next; 

Head->Prev  =  NULL; 

/*  delete  middle  */ 

1  else  if  ((BGEvent->Next  !=  NULL)  &&  (BGEvent->Prev  !=  NULL))  | 
BGEvent->Prev->Next  =  BGEvent->Nexi; 
BGEvent->Next->Prev  =  BGEvent->Prev; 

/*  delete  one-node  list  */ 
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)  else  { 

Head  =  NULL; 

BGEvent  =  NULL; 

free(Head); 

I 

free(BGEvent); 
return  (Head); 

) 

^,i,^m*******m************’i'***************************m********* 

*  This  function  makes  repeated  calls  to  DeleteBGEvent  in  order  to  delete 

*  all  of  the  children  of  the  Parent  event.  Returns  the  head  of  the 

*  battle  group  event  list. 

*1 

BGEVENT*  DeleteChildren(Head,  Parent) 

BGEVENT*  Head; 

RELATION*Parent; 

{ 

if(Parent->Childl  !=NULL)  ( 

Head  =  DeleteBGEvent(Head,  Parent->Childl); 

) 

if  (Parent->Child2  !=  NULL)  { 

Head  =  DeleteBGEvent(Head,  Parent->Child2); 

} 

if  (Parent->Child3  !=  NULL)  { 

Head  =  DeleteBGEvent(Head.  Parent->Child3); 

) 

if  (Parent->Child4  !=  NULL)  ( 

Head  =  DeleteBGEvent(Head.  Parent->Child4); 

I 

if  (Parent->Child5  !=  NULL)  ( 

Head  =  DeleteBGEvent(Head,  Parent->Child5); 

t 

return  (Head); 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  File:  global.!)  ***  */ 

/*  •**  Generated:  Dec  2  16:01:50  1992  ***  */ 

««4i4>4>**Di****4i***<*>4>*************4<***«*4«I>4i**<<>4<*%****4c«***4i4i*************4i* 

*  PURPOSE: 

*  This  global  header  file  is  automatically  “#include”d  in  each  panel 

*  file.  You  can  insert  references  to  global  variables  here. 

*1 

#ifndef  l_GLOBAL  /*  prevent  double  include  */ 

#define  LGLOBAL  0 

/*  macros  for  access  to  parameter  values 

* 

*  These  macros  obtain  parameter  values  given  the  name  of 

*  a  Vm  object  and  the  name  string  of  the  parameter. 

*  The  Vm  objects  are  created  by  the  lniti^ze_All_Panels 

*  function  for  a  resource  file. 

* 

*  Reference  scalar  parameters  as  follows: 

* 

*  StringParm(myPanelTarget,  “s”)  --  string  pointer 

*  lntParm(myPanelTarget,  “i”)  —  integer  value 

*  RealParmfmyPanelTarget,  “r”)  -  real  value 

* 

*  For  vector  parameters,  do  the  following: 

* 

*  TAEINT  *ival; 

*  ival  =  &lntParm(myPanelTarget,  “i”); 

*  printf  (“%d  %d  %d'\  ival(0].  ival(l].  ival(21): 

*/ 

#include  “bg.h” 

#include  “BGEventsLib.h” 
struct  VARIABLE  *Vm_Find  (); 

#define  StringParm(vmld,  name)  (SVAL(*Vm_Find(vmld,  name),0)) 

#define  IntParmfvmld,  name)  (lVAL(*Vm_Find(vmld.  name),  0)) 

#define  RealParmfvmld,  name)  (RVAL(*Vm_Find(vmId,  name),  0)) 

/*  Dispatch  Table  typedef  */ 

typedef  VOID  (♦FUNCT10N_PTR)  (); 
typedef  struct  DISPATCH 
{ 

TEXT  *parmName; 

FUNCTION_PTR  eventFunction; 

}; 

#define  EVENT_HANDLER  static  VOID  /*  a  flag  for  documentation  */ 

/*  Display  Id  for  use  by  direct  Xlib  calls:  */ 

extern  Display  ♦DefauluDisplay; 

#define  SET_APPLlCAT10N_DONE  \ 

|\ 
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extern  BOOL  Application_Done;  \ 
Application_Done  =  TRUE;  \ 

} 


#endif 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_WptHeIp.c  ***  */ 

/*  ***  Generated:  Jan  19  14:53:14  1993  ***  */ 

^  m^l***m*tm<^^t7^ill***^m^tm^lt’tl******m**^^4‘^‘*************************************** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  WptHelp 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_WptHelp.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel's  Id,  Target,  and  View  are  provided. 

* 

*  For  the  panel  items: 

*  (NO  EVENT  GENERATING  ITEMS  IN  THIS  PANEL) 

4c 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated... TAE 

*  ^t**m*i*******************i**m*’)‘**ii*****’t‘************************************ 
*1 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_WptHelp.h” 

/*  One  “include”  for  each  connected  panel  */ 

Id  WptHelpTarget,  WptHelpView,  WptHelpId; 

/*  WptHelpDispatch  is  defined  at  the  end  of  this  file  */ 

4<4c4t4>4t4c4(4c4(4E4c4t4c4t4t4c4t4c4c4c4c4t*«4t4i4>4>4i4c4c4t4E4t4t4t4t4t4t4t4c4c4c4c4>4t4t4t4c4t4c4t4c4t4>4c*4t4c4>4t4c4t4t4c:^4(4c4t**4c 

*  Initialize  the  view  and  target  of  this  panel. 

*1 

FUNCTION  VOID  WptHelp_Initialize_Panel  (vmColIection) 

Id  vmCollection; 

( 

Id  Co.Find  0: 

WptHelpView  =  Co_Find  (vmCollection,  “WptHelp_v”): 

WptHelpTarget  =  Co_Find  (vmCollection,  “WptHelp_f’); 

} 


y4(  4t4c4c4'4c4i4i4c4c4c4c4(4c4c4(4i4c4c4i4<4c4c4c4>4c4c4c4c4c4c4c4c4(4c4c4(4>4c4(4'4c4c4c4>*4c4c4c4c4c4c4c4i4i4c4c*>^4c*4c4i4i4c4>4c4c:^i^4(4c4c 

*  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  WptHelp_Create_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 


if  (WptHelpId) 

printf  (“Panel  (WptHelp)  is  already  displayed.Nn”); 
else 

WptHelpId  =  Wpt_NewPanel  (Default_Display,  WptHelpTarget,  WptHelpView, 
relativeWindow,  WptHelpDispatch.  flags); 


^4t  4i4c4c4c4>4c4c4c4c4c4c4'4(4c4>4c4c4c4c4c4c4c4i4c4c4c4c4(4c4c4i4c4(4>4c4c4c4c4i4c4c4c4c4c#:#4i4i4>4c4c4c4c4c4c4c4c4t4c4c4(4c4c4c4c4c4c4c4i4c4c4c 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*/ 

FUNCTION  VOID  WptHelp_Destn)y_Panel  () 
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Wpt_PanelErase(WptHelpId); 

WptHelpId=0; 

I 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  WptHelp_Connect_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags: 

1 

if  (WptHelpId) 

Wpt_SetPanelState  (WptHelpId,  flags); 
else 

WptHelp_Create_Panel  (relativeWindow,  flags); 

) 


struct  DISPATCH  WptHelpDispatch[]  =  | 

I  NULL,  NULL }  /•  terminator  entry  */ 

I: 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/*  ***  File:  pan.WptHelp.h  •**  */ 

/*  Generated:  Jan  19  14:53:14  1993  ***  */ 

*  PURPOSE: 

*  Header  file  for  panel:  WptHelp 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  WptHelp 

* 

♦  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*/ 

#ifndef  I_PAN_WptHelp  /*  prevent  double  include  */ 

#define  I_PAN_WptHelp  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  WptHelpTarget,  WptHelpView,  WptHelpld; 

/♦  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  WptHelpDispatchQ; 

/*  Initialize  WptHelpTarget  and  WptHelpView  */ 
extern  VOID  WptHelp_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  WptHelp_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  WptHelp_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  WptHelp_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  wpthelp.c  ***  */ 

/*  ***  Generated:  Jan  19  14:53:14  1993  ***  */ 

y*  *ik3|c*«**«*4>4i4>4<*4i*i|<><<>k************«*>ti**4i******4i4i««4i***********>l<*'*<****4«*<***« 

*  PURPOSE: 

*  This  the  main  program  of  an  application  generated  by  the  TAE  Plus  Code 

*  Generator. 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

4c 

*  NOTES: 

*  To  turn  this  into  a  real  application,  do  the  following: 

*  1.  Each  panel  that  has  event  generating  parameters  is  encapsulated  by 

*  a  separate  file,  named  by  concatenating  the  string  “pan_”  with  the 

*  panel  name  (followed  by  a  “.c”).  Each  parameter  that  you  have  defined 

*  to  be  “event-generating”,  has  an  event  l^dler  procedure  in  the 

*  appropriate  panel  file.  Each  handler  has  a  name  that  is  a 

*  concatentation  of  the  parameter  name  and  the  string  “_Event”.  Add 

*  application-dependent  logic  to  each  event  handler.  (As  generated  by 

*  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of  the 

*  event.) 

4c 

*  2.  To  build  the  program,  type  “make”  If  the  symbols  TAEINC,  .... 

*  are  not  defined,  the  TAE  shell  (source)  scripts  STAE/bin/csh/taesetup 

*  will  define  them. 

4c 

*  ADDITIONAL  NOTES: 

*  1.  Each  event  handler  has  two  arguments:  (a)  the  value  vector 

*  associated  with  the  parameter  and  (b)  the  number  of  components.  Note 

*  that  for  scalar  values,  we  pass  the  value  as  if  it  were  a  vector  with 

*  count  1. 

* 

*  Though  it’s  unlikely  that  you  are  interested  in  the  value  of  a  button 

*  event  parameter,  the  values  are  always  passed  to  the  event  handler  for 

*  consistency. 

4c 

*  2.  You  gain  access  to  non-event  parameters  by  calling  the  Vm  package 

*  using  the  targetid  Vm  objects  that  are  created  in 

*  Initialize_All_Panels.  There  are  macros  defined  in  global.h  to  assist 

*  in  accessing  values  in  Vm  objects. 

4c 

*  To  access  panel  Id,  target,  and  view,  of  other  panels,  add  an 

*  “#include”  statement  for  each  appropriate  panel  header  file. 

*  CHANGE  LOG: 

*  I9-Jan-93  Initially  generated...TAE 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “symtab.inc” 

#include  “global.h"  /*  Application  globals  */ 

Display  *Default_Display; 

BOOL  Application_Done  =  FALSE; 

main  (argc,  argv) 
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FUNINT  argc; 
TEXT  *argv[]; 


1 

WptEvent  wptEvent;  /*  event  data  */ 

CODE  eventType; 

COUNT  termLines,  tertnCols; 

CODE  termType; 

/*  PROGRAMMER  NOTE: 

*  add  similar  extern’s  for  each  resource  file  in  this  application 
*! 

extern  VOID  wpthelp_Initialize_All_Panels  (); 
extern  VOID  wpthelp_Create_Initial_Panels  (); 

struct  DISPATCH  *dp;  /*  working  dispatch  pointer  •/ 
IMPORT  struct  VARIABLE  *  Vm_Find(); 

struct  VARIABLE  *pannv;  /*  pointer  to  event  VARIABLE  */ 

I*  initialize  terminal  without  clearing  screen  */ 

Lpinit  (AtermLines,  &tennCols,  &tennType); 

/*  permit  upper/lowercase  file  names  */ 
f_force_lower  (FALSE); 

Default_Display  =  Wpt_Init  (NULL); 

f*  initialize  resource  file  */ 

/*  PROGRAMMER  NOTE: 

*  For  each  resource  file  in  this  application,  calls  to  the  appropriate 

*  Initialize_All_Panels  and  Create_Initial_Panels  must  be  added. 

*( 

wpthelp_lnitialize_All_Panels  (“/h/bglcss/scripts/gui/setup/wpthelp.res”); 
wpthelp_Create_Initial_Panels  (); 

/*  main  event  loop  */ 

!*  PROGRAMMER  NOTE: 

*  use  SET_APPLICATION_DONE  in  "quit”  event  handler  to  exit  loop. 

*  (SET_APPLICATION_DONE  is  defined  in  global.h) 

*/ 

while  (!Application_Done) 

{ 

eventType  =  Wpt_NextEvent  (&wptEvent);  /*  get  next  WPT  event  */ 

switch  (eventType) 

{ 

case  WPT_PARM_EVENT: 

/*  Event  has  occurred  from  a  Panel  Parm.  Lookup  the  event 

*  in  the  dispatch  table  and  call  the  associated  event 

*  handler  function. 

*/ 

dp  =  (struct  DISPATCH  *)  wptEvent.p_useiContext: 
for  (;  (*dp).parmName  !=  NULL:  dp++) 
if  (s_equal  ((*dp).parmName,  wptEvent.parmName)) 

parmv  =  Vm_Find  (wptEvent.p_dataVm.  wptEvent.parmName): 
(*(*dp).eventFunction) 

((*parmv).v_cvp.  (*parmv).v_count); 
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break; 

} 

break; 

case  WPT_FILE_EVENT: 

/*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  file  events. 

*  Use  Wpt_AddEvent  and  Wpt_RemoveEvent  to  register  and  remove 

*  event  sources. 

*/ 

printf  (“No  EVENT_HANDLER  for  event  from  external  source.Nn”); 
break; 

case  WPT_WINDOW_EVENT: 

/*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  window  events. 

*  WPT_WINDOW_EVENT  can  be  caused  by  windows  which  you  directly 

*  create  with  X  (not  TAE  panels),  or  by  user  acknowledgement 

*  of  a  Wpt_PanelMessage  (therefore  no  default  print  statement 

*  is  generated  here). 

*1 

break; 

case  WPT_TIMEOUT_EVENT: 

/*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  timeout  events. 

*  Use  Wpt_SetTimeOu!  to  register  timeout  events. 

*1 

printf  (“No  EVENT_HANDLER  for  timeout  event.\n”); 
break; 


default: 

printf(“Unknown  WPT  EventXn”); 
break; 

1 

)  /*  end  main  event  loop  */ 

Wpt_FinishO;/*  close  down  all  display  connections  */ 

/*  PROGRAMMER  NOTE: 

*  Application  has  ended  normally.  Add  application  specific  code  to 

*  close  down  vour  application 
*/ 


/*  end  .iiain  */ 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  wpthelp_creat_init.c  ***  */ 

/*  Generated:  Jan  19  14:53:14  1993  ***  */ 

^^^^*^^rkl^l^*^^^*:ltt**^^*l¥**’¥**%*r|‘*^*^^:*l*i*************^  t************************** 

*  PURPOSE: 

*  Displays  all  panels  in  the  initial  panel  set  of  this  resource  file 

*  REGENERATED: 

*  The  following  WotkBench  operations  will  cause  regeneration  of  this  file: 

*  A  panel  is  added  to  the  initial  p^el  set 

*  A  panel  is  deleted  from  the  initial  panel  set 

*  For  the  set  of  initial  panels: 

*  WptHelp 

* 

*  CHANGE  LOG: 

*  19- Jan-93  Initially  generated...TAE 
*! 

#include  “taeconf.inp” 

#include  “wplinc.inp” 

#include  “global.h”  /*  Application  globals  *! 

/*  One  include  for  each  panel  in  initial  panel  set  */ 

#include  “pan_WptHelp.h” 


FUNCTION  VOID  wpthelp_Create_Initial_Panels  () 

I 

I*  Show  panels  */ 

WptHelp_Create_Panel  (NULL,  WPT_PREFERRED): 
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/*  **’"  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  **♦  File:  wpthelp_init_pan.c  ***  */ 

I*  ***  Generated:  Jan  19  14:53:14  1993  ***  ♦/ 

j^L  ^n,^^^,^,^i^,^t,^^ti****^^*^^^^^^****^^^H^****’^*^^**t*****^^***^***^^*****^^***^^■^^************ 

*  PURPOSE: 

*  Initialize  all  panels  in  the  resource  file. 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  A  panel  is  deleted 

*  A  new  panel  is  added 

*  A  panel's  name  is  changed  (not  title) 

*  For  the  panels: 

*  WptHelp 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated... TAE 
*/ 

#include  "taeconf.inp” 

#include  “wptinc.inp" 

#include  “symtab.inc” 

#include  “global.h”  /*  Application  globals  */ 

/*  One  “include”  for  each  panel  in  resource  file  */ 

#include  “pan_WptHelp.h” 


FUNCTION  VOID  wpthelp_Initialize_All_Panels  (resfileSpec) 
TEXT  *resfileSpec; 

I 

extern  Id  Co_Find  Q: 
extern  Id  Co_New  (); 

Id  vmCollection ; 

f*  read  resource  file  */ 
vmCollection  =  Co_New  (P_ABORT); 

Co_ReadFile  (vmCollection,  resfileSpec,  P_ABORT): 

/*  initialize  view  and  target  Vm  objects  for  each  panel  */ 
WptHelp_Initialize_Panel  (vmCollection); 

1 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  BGSetup.c  ***  */ 

/*  ***  Generated:  Dec  2  16:01:50  1992  ***  */ 

*  PURPOSE: 

*  This  the  main  program  of  an  application  generated  by  the  TAE  Plus  Code 

*  Generator. 

* 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

* 

*  NOTES: 

*  To  turn  this  into  a  real  application,  do  the  following: 

* 

*  1.  Each  panel  that  has  event  generating  parameters  is  encapsulated  by 

*  a  separate  file,  named  by  concatenating  the  string  “pan_”  with  the 

*  panel  name  (followed  by  a  “.c”).  Each  parameter  that  you  have  defined 

*  to  be  “event-generating”,  has  an  event  handler  procedure  in  the 

*  t^ipropriate  panel  file.  Each  handler  has  a  name  that  is  a 

*  concatentation  of  the  parameter  name  and  the  string  “_Event”.  Add 

*  application-dependent  logic  to  each  event  handler.  (As  generated  by 

*  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of  the 

*  event.) 

* 

*2.  To  build  the  program,  type  “make”.  If  the  symbols  TAEINC . 

*  are  not  defmed,  the  TAE  shell  (source)  scripts  STAE/bin/csh/taesetup 

*  will  define  them. 

* 

*  ADDITIONAL  NOTES: 

*  I .  Each  event  handler  has  two  arguments:  (a)  the  value  vector 

*  associated  with  the  parameter  and  (b)  the  number  of  components.  Note 

*  that  for  scalar  values,  we  pass  the  value  as  if  it  were  a  vector  with 

*  count  1. 

* 

*  Though  it’s  unlikely  that  you  are  interested  in  the  value  of  a  button 

*  event  parameter,  the  values  are  always  passed  to  the  event  handler  for 

*  consistency. 

* 

*  2.  You  gain  access  to  non-event  parameters  by  calling  the  Vm  package 
using  the  targetid  Vm  objects  that  are  created  in 

*  Initi^ze_All_Panels.  There  are  macros  defmed  in  global  .h  to  assist 

*  in  accessing  values  in  Vm  objects. 

* 

*  To  access  panel  Id,  target,  and  view,  of  other  panels,  add  an 

*  “#include”  statement  for  each  appropriate  panel  header  file. 

*  *«*4>****«4i*******4i4<*****«******4>**4<4>*4>4i****************4^*******M<******** 
*/ 

#inciude  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “symtab.inc” 

#include  “global.h”  /*  Application  globals  */ 

Display  *Default_Display; 

BOOL  Application_Done  =  FALSE; 

main  (argc,  argv) 

FUNINT  argc; 

TEXT  *argv(]; 
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WptEvent  wptEvent; 
CODE  eventType; 


/*  event  data  */ 


COUNT  temiLines,  tennCols; 

CODE  tennTypey*BERN*/ret; 

/♦BERN*/ 

/*  PROGRAMMER  NOTE; 

*  add  similar  extern's  for  each  resource  file  in  this  application 
*1 

extern  VOID  BGSetup_lnitialize_Ali_Panels  (); 
extern  VOID  BGSetup_Create_Initial_Panels  0: 

struct  DISPATCH  *dp;  /*  working  dispatch  pointer  */ 

IMPORT  struct  VARIABLE  *Vm_Findp; 

struct  VARIABLE  *parmv;  /*  pointer  to  event  VARIABLE  */ 

/*  initialize  terminal  without  clearing  screen  */ 
t_pinit  (&termLines,  &termCoIs.  &temiType); 

/*  permit  upper/lowercase  file  names  */ 
f_force_lower  ^ALSE); 

Default_Display  =  Wpt_Init  (NULL); 

/*  initialize  resource  file  */ 

/*  PROGRAMMER  NOTE; 

*  For  each  resource  file  in  this  application,  calls  to  the  appropriate 

*  lnitialize_All_Panels  and  Create_Initial_Panels  must  be  added. 

*1 

BGSetup_Initialize_AIl_Panels  ("/h/bgIcss/scripts/gui/setup/BGSetup.res”); 
BGSetup_Create_lnitial_Panels  Q; 

/*  main  event  loop  */ 

/*  PROGRAMMER  NOTE; 

*  use  SET_APPLICATION_DONE  in  “quit”  event  handler  to  exit  loop. 

*  (SET_APPLICATION_DONE  is  defined  in  giobal.h) 

*/ 

/♦BERN*/ 

ret  =  Wpt_SetHelpStyle  (“wpthelp.res”); 
if  (ret  !=  SUCCESS) 

ptintf(“Couldn’t  set  help  styleNn”); 


while  (!Application_Done) 

{ 

eventType  =  Wpt_NextEvent  (&wptEvent);  f*  get  next  WPT  event  ♦/ 

switch  (eventType) 

I 

case  WPT_PARM_EVENT; 

/♦  Event  has  occurred  from  a  Panel  Parm.  Lookup  the  event 

♦  in  the  dispatch  table  and  call  the  associated  event 

*  handler  function. 

*1 

dp  =  (struct  DISPATCH  ♦)  wptEvent.p_useiContext; 
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for  (;  (*dp).parmName  !=  NULL;  dp++) 
if  (s_equal  ((*dp).parmName,  wpiEventparmName)) 

{ 

parmv  =  Vm_Find  (wptEvent.p_dataVm.  wptEvent.parmName); 
(*(*dp).eventFunction) 

((*pannv).v_cvp,  (♦parmv).  v_counO; 
break; 

I 

break; 

case  WPT_FILE_EVENT; 

/♦  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  file  events. 

*  Use  Wpt_AddEvent  and  Wpt_RemoveEvent  to  register  and  remove 

*  event  sources. 

*1 

printf  (“No  EVENT_HANDLER  for  event  from  external  source.Nn”); 
break; 

case  WPT_WINDOW_EVENT; 

/*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  window  events. 

*  WPT_WINDOW_EVENT  can  be  caused  by  windows  which  you  directly 

*  create  with  X  (not  TAE  panels),  or  by  user  acknowledgement 

*  of  a  Wpt_PanelMessage  (therefore  no  default  print  statement 

*  is  generated  here). 

*/ 

break; 

case  WPT_TIMEOUT_EVENT: 

/*  PRCXjRAMMER  NOTE: 

*  Add  code  here  to  handle  timeout  events. 

*  Use  Wpt_SetTimeOut  to  register  timeout  events. 

♦/ 

printf  (“No  EVENT_HANDLER  for  timeout  event.Nn”); 
break; 

default; 


printf(“Unknown  WPT  EventVi”); 
break; 

I 

}  /*  end  main  event  loop  ♦/ 

Wpt_FinishO;/*  close  down  all  display  connections  */ 

/*  PROGRAMMER  NOTE: 

*  Application  has  ended  normally.  Add  application  specific  code  to 

*  close  down  your  application 
•/ 

t 


f*  end  main  */ 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  BGSetup_creat_init.c  ***  */ 

/*  ***  Generated;  Jan  19  11:14:17  1993 

*  PURPOSE: 

*  Displays  all  panels  in  the  initial  panel  set  of  this  resource  file 

* 

*  REGENERATED: 

*  The  following  WoikBench  operations  will  cause  regeneration  of  this  file: 

*  A  panel  is  added  to  the  initial  pwel  set 

*  A  panel  is  deleted  from  the  initial  panel  set 

*  For  the  set  of  initial  panels: 

*  SetUpBGs 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 

Tic  :ic*iicTiciiC3iciic:^*:^^Hc^c^ciiciicicTic;ti******^*****^******!**********if***^*****’¥************* 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

/*  One  include  for  each  panel  in  initial  panel  set  */ 

#include  “pan_SetUpBGs.h” 


FUNCTION  VOID  BGSetup_Create_Initial_PaneIs  () 

{ 

/*  Show  panels  */ 

SetUpBGs_Create_Panel  (NULL,  WPT_PREFERRED); 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:2/  EDT  1992  ***  */ 

/*  ***  File:  BGSetup_init_pan.c  ’•■**  */ 

/*  ***  Generated:  Jan  19  11:14:17  1993  **♦  */ 

!*  ******’**************************m****************:t********************** 

*  PURPOSE: 

*  Initialize  all  panels  in  the  resource  file. 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  A  panel  is  deleted 

*  A  new  panel  is  added 

*  A  panel's  name  is  changed  (not  title) 

*  For  the  panels: 

*  AcftLoad,  AirData,  BGData,  BGShips,  CloseAll,  DelBG,  DeleteSh, 

*  DelShip,  Dtg,  F44Fuel,  F76Fuel,  LackDaia.  NewBG,  OrdData, 

*  OrdLo^,  OrdSel,  PrintJob,  SaveNewB.  SelBG,  SetUpBGs.  Ship. 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 

*1 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  "symtab.inc" 

#include  “global.h”  /*  Application  globals  */ 

/*  One  “include”  for  each  panel  in  resource  file  */ 

#include  “pan_AcftLoad.h” 

#include  “pan_AirData.h” 

#include  “pan_BGData.h” 

#include  “pan_BGShips.h” 

#include  “pan_CIoseAll.h” 

#include  “pan_DelBG.h” 

#include  “pan_DeleteSh.h” 

#include  “pan_DelShip.h” 

#include  “pan_Dtg.h” 

#include  “pan_F44Fuel.h” 

#include  “pan_F76Fuel.h” 

#include  “pan_LackData.h” 

#include  “pan_NewBG,h” 

#include  “pan_OrdData.h” 

#include  “pan_OrdLoad.h” 

#include  “pan_OrdSel.h” 

#include  “pan_PrintJob.h” 

#include  “pan_SaveNewB.h” 

#include  “pan_SelBG.h” 

#include  “pan_SetUpBGs.h” 

#include  “pan_Ship.h” 


FUNCTION  VOID  BGSetup_lnitialize_All_Panels  (resfileSpec) 
TEXT  *resfileSpec; 

( 

extern  Id  Co_Find  0; 
extern  Id  Co_New  (); 

Id  vmCollection  ; 

f*  read  resource  file  */ 
vmCollection  =  Co_New  (P_ ABORT); 

Co_ReadFile  (vmCollection,  resfileSpec,  P_ABORT); 
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/*  initialize  view  and  target  Vm  objects  for  each  panel  */ 
AcftLoad_Initialize_Panel  (vmCollection); 
AirData_Initialize_Panel  (vmCollection); 
BGData_Initialize_Panel  (vmCollection); 
BGShips_Initialize_Panel  (vmCollection); 
CloseAll_Initialize_Panel  (vmCollection); 
DeIBG_Initialize_Panel  (vmCollection); 
DeleteSh_Initialize_Panel  (vmCollection); 
DelShip_Initialize_Panel  (vmCollection); 
Dtg_Initialize_Panel  (vmCTollection); 
F44Fuel_Initialize_Panel  (vmCollection); 
F76Fuel_Initialize_Panel  (vmCollection); 
LackData_Initialize_Panel  (vmCollection); 
NewBG_Initialize_Panel  (vmCollection); 
OrdData_lnitiali2e_Panel  (vmCollection); 
OrdLoad_Initialize_Panel  (vmCollection); 
OrdSel_Initialize_Panel  (vmCollection); 
PrintJob_Initialize_Pane!  (vmCollection); 
SaveNewB_Initialize_Panel  (vmCollection); 
SelBG_Initialize_Panel  (vmCollection); 
SetUpBGs_Initialize_Panel  (vmCollection); 
Ship_Initialize_Panel  (vmCollection); 

I 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  */ 

f*  ***  File:  Imakefile  ***  */ 

/*  ***  Generated:  Nov  27  1 1:24:06  1992  **♦  */ 

*  PURPOSE: 

*  This  is  the  Imakefde  of  a  C  application  generated  by  the  TAE  Plus 

*  Code  Generator. 

* 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

'll 

*  NOTES: 

*  1.  To  build  your  application,  type  “make”.  The  Makefile  generated 

*  by  the  TAE  code  generator  invokes  imake  using  this  Imakefile  to 

*  generate  an  application  specific  Makefile. 

* 

*  2.  If  you  change  the  name  of  your  resource  file  or  application,  you 

*  will  need  to  either  edit  this  fde,  or  just  delete  it  and  regenerate 

*  the  code. 

* 

*  3.  Edit  this  file  to  include  your  application  specific  source  files. 

*/ 

#define  GeneratedApplication 
/*  PROGRAMMER  NOTE: 

*  Add  a  line  '#include  “Imake.RESFILENAME”’  for  each  resource  file  in 

*  your  application. 

*/ 

#include  “Imake.BGSetup” 


/*  PROGRAMMER  NOTE; 

*  Insert  application  specific  build  parameters.  These  override 

*  definitions  in  the  configuration  files  in  $TAE/config. 

*1 

CDEBUGFLAGS  = 

LDDEBUGFLAGS  = 

APP_CFLAGS  = 

APP  I  OAD  R  AG<!  = 

APP_LINiaiBS  =  -L/h/Nauticus/Ubs  -IVids 
APP_DEPLIBS  =  S(DEPLIBS) 

APP.CINCLUDES  =  -IS<  i  A£iNC,«  \ 

-I/h/Nauticus/include/vidsA'ids.hX 
-I/hi^glcss/scripts/gui/setup/bg.h 
PROGRAM  =  BGSetup 

/*  PROGRAMMER  NOTE: 

*  Add  $(SRCS_RESFILENAME)  and  $(OBJS_RESFlLENAME)  for  each  resource  file 

*  in  your  application. 

*/ 

GENSRCS  =  $(PROGRAM).c  $(SRCS_BGSetup) 

GENOBJS  =  $(PROGRAM).o  $(OBJS_BGSetup) 

/*  PROGRAMMER  NOTE: 

*  Add  your  application  specific  srcs  and  object  files  (that  are  not 

*  generated  by  the  code  generator)  here. 

*1 

APPSRCS  =  bg.c 
APPOBJS  =  bg.o 
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/*  Macro  (defined  in  TAEmake.tmpl)  to  generate  Makefile  targets. 
*/ 

CApplication{$(PROGRAM)) 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

I*  ***  File:  pan_BGDatac  ***  */ 

/*  Generated:  Jan  19  1 1:14:17  1993  **♦  */ 

^  *4i*>|i4,«4<*i)c«*«4<4i4<*«*4>**«*>)>**********«*«*«****>)>***'<<«****4>****************** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel;  BGDtua 

These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_BGData.h’”.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_BGData.h” 

/*  One  “include”  for  each  connected  panel  */ 

#include  “pan_BGShips.h” 

#include  “pan_DeleteSh.h” 

#include  “pan_Ship.h” 

/*BERN*/ 

#include  “pan_SetUpBGs.h” 

/‘BERN*/ 

extern  void  CancelBGQ; 

extern  int  GetBGO; 

extern  int  GetBGs(); 

extern  void  ShowBGO; 

extern  void  ShowBGShipsO; 

Id  BGDataTarget,  BGDataView.  BGDatald; 

/*  BGDataDispatch  is  defined  at  the  end  of  this  file  */ 

y*  ****]«,***«**i|,4c**«**«**4>*****4i***«***4i>l»l>4c4>«**4'*****3t>********4i***%**%*****4t 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  BGData_Initialize_Panel  (vmCollection) 

Id  vmCollection; 
i 

Id  Co_Find  0: 

BGDataView  =  Co_Find  (vmCollection,  “BGData_v”); 

BGDataTarget  =  Co_Find  (vmCollection.  “BGData_f’); 

1 


*  Create  the  panel  object  and  display  it  on  the  screen. 

•/ 

FUNCTION  VOID  BGData_Create_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 

I 

/♦BERN*/ 
int  BGIndex; 

BGInfo  BGsfMAXBGS]; 

if  (BGDatald) 

printf  (“Panel  (BGData)  is  already  displayed.Nn”); 
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else 


BGDatald  =  Wpt_NewPanel  (Default_Display,  BGDataTarget, 
BGDataView.  relativeWindow,  BGDataDispatch.  flags): 

BGlndex  =  GetBGs(BGs); 

BGIndex  =  GetBG(StringPann(SetUpBGsTarget,”BGList").  BGlndex); 
ShowBG(BGs,  BGlndex,  BGDatald); 

ShowBGShips(BGIndex.  BGDatald,  “BGShips”); 


*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*1 

FUNCTION  VOID  BGData_Destroy_Panel  () 

{ 

CancelBG(BGDatald); 

Wpt_PanelErase(BGDataId); 

BGDataId=0; 

1 


IrtHHt^t^t****************^^**********^^:^!**************************************** 

*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  BGData_Connect_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

{ 

if  (BGDatald) 

Wpt_SetPanelState  (BGDatald,  flags); 
else 

BGData_Create_Panel  (relativeWindow,  flags); 

I 


*  Handle  event  from  parameter;  AddShip 
*1 

EVENT_HANDLER  AddShip_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

f*  Begin  generated  code  for  Connection  */ 
BGShips_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

} 


I*  *•****♦**♦***♦**♦♦•*•*•♦•♦********♦****♦♦***♦♦♦*******♦♦♦********♦♦**♦** 

*  Handle  event  from  parameter:  Close 
*/ 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  generated  code  for  Connection  ♦/ 

BGData_Destroy_Panel  (); 

/*  End  generated  code  for  Connection  ♦/ 


I.*;! 


} 


1^1  *4>itc«4>*4<«4>**4<*>l>4>4>***4<4>*********i|i*4<4i***«**4i4i*********4>4i*4i***************** 

*  Handle  event  from  parameter:  Delete 
*1 

EVENT_HANDLER  Delete_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /•  num  of  values  */ 

( 

f*  Begin  generated  code  for  Connection  */ 

Deletes h_Connect_Panel  (NULL,  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

1 


y*  4i*4i*****4'4'*4<**4>4<*****4<***i|>**4>4<****«**4i**4<*4>’I'***4<*********4<**4<*********4'4< 

*  Handle  event  from  parameter:  Edit 
*/ 

EVENT_HANDLER  Edit_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 

Ship_Connect_Panel  (NULL,  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

} 


I*  :f*l’>'*****tl‘**’H**'**************************************’>‘’*’>‘***********’****** 

*  Handle  event  from  parameter:  Help 

V 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 


^,^,^„tl*:>,^,^,^,^,^,^,^,*^,^,^,^,^l^t^,*******^l*********m**********^‘*****  **************** 

*  Handle  event  from  parameter;  Save 

V 

EVENT_HANDLER  Save_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

I 


struct  DISPATCH  BGDataDispatch[l  =  1 
(“AddShip”,  Adds hip_E vent). 

{"Close”,  CIose_Event}, 

{“Delete”,  Delete_Event|. 
j  “Edit”,  Edit_E  vent ) , 

{ “Help”,  Help_Event } , 

(“Save”,  Save_Event|, 

{ NULL,  NULL )  /*  terminator  entry  */ 
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I*  ♦**  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGData.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

lt:^^**^i^^^^^^***m*^****^^******^^^^’|^******m*******^^^^***  ^***^^^****^^**m^^*■t^******* 

*  PURPOSE: 

*  Header  file  for  panel:  BGData 

* 

*  REGENERATED: 

*  The  following  WoikBench  operations  will  cause  regeneration  of  tnis  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  BGData 

* 

*  CHANGE  LOG: 

*  19-jan-93  Initially  generated...TAE 
*/ 

#ifndef  I_PAN_BGData  /*  prevent  double  include  */ 

#define  I_PAN_BGData  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  BGDataTarget,  BGDataView,  BGDauild; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  BGDalaDispatch[]; 

/*  Initialize  BGDataTarget  and  BGDataView  */ 
extern  VOID  BGData_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  BGData_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  BGData_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  BGData_Connect_Panel  (); 

#endif 
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/*  TAE  Plus  Code  Generator  version  Tue  May  26  14;  13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGShips.c  ***  */ 

/*  ***  Generated:  Jan  19  1 1:14:17  1993  ***  */ 

|^^  ^^:^i^^1fit^,^Lm*****-¥**‘***%*****************************^******************** 

*  PURPOSE; 

*  This  file  encapsulates  the  TAE  Plus  panel:  BGShips 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ■#include  “pan_BGShips.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_BGShips.h” 

/*  One  “include”  for  each  connected  panel  */ 

#include  “pan_Ship.h” 

/•BERN*/ 

#include  “pan_NewBG.h” 

#include  “pan_SetUpBGs.h” 

#include  ”pan_BGData.h” 

extern  void  ShowNavyShipsO; 

extern  int  GetBGsO; 

extern  int  GetBGShipsO; 

extern  int  GetBG(): 

extern  void  ShowBGShips(); 

extern  char*  AddShipf); 

extern  void  SaveBGShipsO; 

Id  BGShipsTarget,  BGShipsView,  BGShipsId; 

/•  BGShipsDispatch  is  defined  at  the  end  of  this  file  •/ 

•4i4i***4i4i4t«***;ti*4>********4<*>)<***’l<***4i**>)<%*******4>******4i****4i»******* ***>•(* 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  BGShips_Initialize_Panel  (vmCollection) 

Id  vmCollection; 

I 

Id  Co_Find  Q: 

BGShipsView  =  Co_Find  (vmCollection,  “BGShips_v”); 

BGShipsTarget  =  Co_Find  (vmCollection,  “BGShipsj”); 

i 

*  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  BGShips_Create_Pancl  (relativeWindow.  flags) 

Window  relativeWindow; 

COUNT  flags; 

( 

/•BERN*/ 

TEXT*  bgnamel  1  ]; 

int  BGIndex  =  0; 

if(PGShipsld)l 
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printf  (“Panel  (BGShips)  is  already  displayed.'^”); 

)else( 

BGShipsld  =■  Wpt_NewPanel  (Defaiilt_Display,  BGShipsTarget, 
BGShipsView,  relativeWindow.  BGShipsDispaich,  flags); 

/*pass  new  BG  Name  from  appropriate  panel  to  BG  Ships  panel*/ 
if(NewBGId){ 

strcpy(bgname[0],  StringParm(NewBGTarget.”Name“)); 

I  else  { 

bgnamefO]  =  StringParm(BGDataTarget."Name”); 

) 

Vm_SetString(BGShipsView,”Name.textstrs'M.bgname.P_LJPDATE); 
Wpt_ViewUpdate(BGShipsId.“Name”,  BGShipsView,”Name’’); 
ShowNavyShips(BGShipsId  “NavyShips”); 
if  (BGDataId)( 

BGlndex  =  GetBG(bgname[0],BGIndex); 

ShowBGShipsfBGIndex,  BGShipsld,  "BGShips’'); 

) 

1 

I 


*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*/ 

FUNCTION  VOID  BGShips_Destroy_Panel  () 

{ 

Wpt_PanelErase(BGShipsId); 

BGShipsld=0; 

I 


ji^  * 4e 4c4c ** 4t 4t 4r4r 4c 4t 4c « ** ******** 4c 4c 

*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  BGShips_Connect_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

I 

if  (BGShipsld) 

Wpt_SetPanelSiate  (BGShipsld,  flags); 
else 

BGShips_Create_Panel  (relativeWindow,  flags); 

1 


y*  *********************************************************** **********^** 

*  Handle  event  from  parameter:  AddShipToBG 
*/ 

EVENT_HANDLER  AddShipToBG_Event  (value,  count) 

TEXT  *value[]:  /*  .string  pointers  •/ 

FUNINT  count;  /*  num  of  values  */ 


/*BERN*/ 

BGlnfo 

F76ShipTypelnfo 

int 

int 


BGsfMAXBGS); 

F76TablelMAXSHlPTYPESl; 

NewBG; 

NewShip; 
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NewBG  =  GetBGs(BGs); 

NewBG  =  GeiBG(  StringParm(NewBGTarget.'’Name”),  NewBG): 

NewShip  =  GetBGShips(BGs,  NewBG,  F76Table); 

AddShip(BGs,NewBGJ^ewShip, 

StringPann(BGShipsTarget,”NavyShips”)); 

SaveBGShips(BGs,  NewBG); 

ShowBGShips(NewBG.BGS‘iipsld,  “BGShips”); 


*  Handle  event  from  parameter;  Close 
*/ 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 

BGShips_Destroy_Panel  (); 

t*  End  generated  code  for  Connection  */ 

1 


jif  ^^l^l^l^^^^^^■^m^^^^**■^^*^^^^^^^H^^^^^**^^M^*^^*1^********>^*****1>i*****^c*********m****^r****** 

*  Handle  event  from  parameter:  EditShip 
♦/ 

EVENT_HANDLER  EditShip_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  *! 

FUNINT  count;  /*  num  of  values  */ 

{ 

/•  Begin  generated  code  for  Connection  */ 

BGShips_Destroy_Panel  (); 

Ship_Connect_Panel  (NULL,  WPT.PREFERRED); 

[*  End  generated  code  for  Connection  */ 

} 


jm  ***♦*♦*****♦**♦******♦*♦***♦♦*****♦*♦%**♦*******♦♦*♦**♦♦♦*♦*♦***♦***♦*♦♦ 

*  Handle  event  from  parameter:  Help 
*/ 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

1 


*  Handle  event  from  parameter:  RemoveFromBG 
*/ 

EVENT_HANDLER  RemoveFromBG_Event  (value,  count) 
TEXT  *value[]:  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

1 


*  Handle  event  from  parameter:  SaveBGShips 
*/ 

EVENT_HAr4DLER  SaveBGShips_Event  (value,  count) 


156 


TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  nutn  of  values  */ 

I 
} 


struct  DISPATCH  BGShipsDispatch[]  =  | 

( “ AddShipToBG”,  AddShipToBG_E vent ) . 

(“Close”,  Close_Event}, 

{ “EditShip”.  EditShip_Event  1 . 

(“Help”,  Help_Event), 

( “RemoveFromBG”,  Remo  veFromBG_E  vent  | , 

( “SaveBGShips”,  SaveBGShips_E vent } , 

( NULL,  NULL )  /*  terminator  entry  */ 

}; 


157 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14: 13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGShips.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

y*  ^**m*%mm*mm***^‘**-******************tit***********'^************************ 

*  PURPOSE: 

*  Header  file  for  panel:  BGShips 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  BGShips 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 

V 

#ifndef  l_PAN_BGShips  /*  prevent  double  include  */ 

#define  I_PAN_BGShips  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  BGShipsTarget,  BGShipsView,  BGShipsId; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  BGShipsDispatch[]; 

/*  Initialize  BGShipsTarget  and  BGShipsView  */ 
extern  VOID  BGShips_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  BGShips_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  BGShips_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  BGShips_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_CloseAll.c  ***  */ 

/*  ***  Generated:  Jan  19  11:14:17  1993  **♦  */ 

l^i  **«*«>|i««**«««:ti***4<4i<li««***4<«***4<**>*>4i*****«*4<***«**4i****««>l>***«*>tt********* 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  CloseAU 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_CloseAll.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  ”pan_CloseAll.h” 

Id  CloseAllTarget,  Close  All  View,  Close  Allld; 

/*  CloseAUDispatch  is  defined  at  the  end  of  this  file  */ 

jAt  ***4<**4>*****’<'>*<**>)>***>t<**4>*4<«****>t<«***><i*4<*ik*>l<**4<*>l>**4<*************>t<>l>*>l>**** 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  CloseAll_Initialize_Panel  (vmCollection) 

Id  vmCollection; 

{ 

Id  Co_Find  0: 

CloseAUView  =  Co_Find  (vmCollection,  “CloseAll_v”); 

CloseAllTarget  =  Co_Find  (vmCollection,  “CloseAll_t”): 

} 


FUNCTION  VOID  CloseAll_Create_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

I 

if  (CloseAllld) 

printf  (“Panel  (CloseAU)  is  already  displayed.Nn’’); 
else 

CloseAlUd  =  Wpt_NewPanel(Default_Display,  CloseAllTarget. 

CloseAUView,  relativeWindow,  CloseAUDispatch,  flags); 

} 

y*  * * 4r3|t ]*( *41 4i * 4c** 4(4c4c*4>3|i4c*4t4t4t4(*4(4(4<4i>|()tc 4c *341  *4(4(41 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*1 

FUNCTION  VOID  CloseAU_Destroy_Panel  () 

{ 

Wpt_PanelErase(CloseAlUd); 

Close  AUId=0; 


!*  **«*;|i***K.*****4i>ti:ti***i)l,ti*:ti««**4c*«*,)i***«*«*«***««*«4, ********** *****41  *41***** 

*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  CloseAll_Connect_Panel  (relativeWindow,  flags) 
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Window  relativeWindow; 

COUNT  flags; 

( 

if  (CloseAllId) 

Wpt_SetPanelState  (CloseAllId,  flags); 
else 

CloseAll_Create_Panel  (relaliveWindow,  flags); 


*  Handle  event  from  parameter;  message 
*1 

EVENT_HANDLER  message_Event  (value,  count) 
TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 
if  (count  <=  0) 

;  /*  null  value  or  no  value  */ 

else  if  (s_equal  (value[0],  “OK”)) 

{ 

CloseAll_Destroy_Panel  (); 
SET_APPLICATION_DONE; 

1 

else  if  (s_equal  (value[0],  “Cancel”)) 

( 

CloseAll_Uestroy_Panel  (); 

1 


/*  End  generated  code  for  Connection  */ 

1 

struct  DISPATCH  CloseAllDispatch[]  =  | 

(“message”,  message_Event), 

{ NULL,  NULL }  I*  terminator  entry  */ 

1; 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  **♦  */ 

/*  ***  File:  pan_CloseAll.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

I*  ^>^l*^********^|t***^t*^l**^t*****^^t*m*************************************^im** 

*  PURPOSE: 

*  Header  file  for  panel:  CloseAll 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel's  name  is  changed  (not  title) 

*  For  panel: 

*  CloseAU 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 

*  Ai:t>**^‘*******m*m*********^‘******^^*******************^i*******:************:^** 
*/ 

#ifndef  I_PAN_Close  All  /*  prevent  double  include  */ 

#define  I_PAN_CloseAll  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  Close  AllTarget,  Close  All  View,  CloseAllId; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  CloseAIlDispatch[]; 

/*  Initialize  CloseAIlTarget  and  CloseAllView  */ 
extern  VOID  CloseAll_Initialize_Panel  (); 

I*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  CloseAll_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  CloseAll_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  *1 
extern  VOID  CloseAll_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_DelBG.c  *•*  */ 

/*  ***  Generated:  Feb  8  10:13:45  1993  ***  */ 

iim^,*<nt^i>tt:t,**m^t^t^t:tt4,^m’>‘m**********m*******’*******************************’i‘* 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  DelBG 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_DelBG.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

* 

*  For  the  panel  items: 

*  Message 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated...TAE 

4c  4c4c4c4c4t4t4t4c4c4c4>4c4c4(4c4c4(4c4c4c4c4i4c4i4c4c4c4t4(4c4>4c4c4c4i4c4citc4c4c4t4c4c4t4c4c4c4t%4c4c4(4(4(4c4c4t*4t4t4c4c4c4c4c4c4c4c4c4c4t4c4c4c 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_DelBG.h” 

/*  One  “include”  for  each  connected  panel  */ 

/♦BERN*/ 

#include  “pan_SetUpBGs.h” 

extern  int  GetBGsO; 

extern  int  GetBG(): 

extern  void  DeleteBG(); 

extern  void  SaveBGs(); 

extern  void  ShowBGsQ; 


Id  DelBGTarget,  DelBGView,  DelBGld; 

/*  DelBGDispatch  is  defined  at  the  end  of  this  file  ♦/ 

y*  *m*******************************************************************i¥** 

♦  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  DelBG_Initialize_Panel  (vmCollection) 

Id  vmCollection; 

I 

Id  Co_Find  0; 

DelBGView  =  Co_Find  (vmCollection,  “DelBG_v”); 

DelBGTarget  =  Co_Find  (vmCollection,  “DelBGj”): 


^4c  4r4r4r4t4c4c4c4c4r4c4r4r4c4r4c4c4c4c4c*4^4c4t*4r4c4(4c4i4c4(*4t4c4c4c4(4c4c4c4c4t4c4c4r*4c4c4t*4r4c4r4c4c4t4c4t4c4(4c4c4c4c4c4c4t4i4c4r4c4c 

♦  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  DelBG_Create_Panet  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  Hags; 

I 

if  (DelBGld) 

printf  (“Panel  (DelBG)  is  already  displayed.Nn”); 
else 


DelBGld  =  Wpt_NewPanel  (Defaiilt_Display,  DelBGTarget,  DelBGView, 
relativeWindow,  DeIBGDispatch,  flags); 


jir  4r4i*4ii|i*****4c*4<********%**4i4c*«<)i*****4>****«***4i%««**4>«*4i4i4i4<4c***4i****4i*«*4<** 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

V 

FUNCTION  VOID  DeIBG_Destroy_Panel  () 

I 

Wpt_PaneIErase(DeIBGId); 

DeIBGId=0; 

} 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*! 

FUNCTION  VOID  DeIBG_Connect_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 

{ 

if  (DelBGld) 

Wpt_SetPanelState  (DelBGld.  flags); 
else 

DelBG_Create_Panel  (relativeWindow,  flags); 

I 


*  Handle  event  from  parameter:  Message 

V 

EVENT_HANDLER  Message_Event  (value,  count) 
TEXT  *value[]:  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 


/*BERN*/ 

BGlnfo  BGs[MAXBGS]; 

int  BGToDelete; 

int  BGIndex; 

f*  Begin  generated  code  for  Connection  */ 

if  (count  <=  0) 

;  /*  null  value  or  no  value  */ 

else  if  (s_equal  (value[01,  “OK”)) 

{ 

BGIndex  =  GetBGs(BGs); 

BGToDelete=GetBG(SuingParm(SetUpBGsTarget,”BGList”),  BGIndex); 
DeleteBG(BGs,BGToDelete); 

SaveBGs(BGs); 

ShowBGs(SetUpBGsld,"BGList”); 

DelBG_Destroy_Panel  (); 


I 

else  if  (s_equal  (value[0],  “Cancel”)) 

I 
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DelBG_Destroy_Panel  (); 


I 

/*  End  generated  code  for  Connection  */ 

1 


struct  DISPATCH  DelBGDispatch[]  =  | 

(“Message”,  Message_Event}, 

( NULL,  NULL  |  /*  terminator  entry  •/ 

1; 


164 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  **♦  File:  pan.DelBG.h  ***  ♦/ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

Ki******4i4<4i4<>l<***4c***4<***********«*>t>****4<»******«*******4>*>ti***4< ***%******* 

*  PURPOSE: 

*  Header  file  for  panel:  DelBG 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel's  name  is  changed  (not  title) 

*  For  panel; 

*  DelBG 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*/ 

#ifndef  I_PAN_DelBG  /*  prevent  double  include  */ 

#define  I_PAN_DelBG  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  DelBGTarget,  DelBCJView,  DelBGId; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  DelBGDispatchd; 

/*  Initialize  DelBGTarget  and  DelBGView  */ 
extern  VOID  DeIBG_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  DelBG_Create_Panel  0: 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  DelBG_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  DelBG_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ♦**  File:  pan_Dtg.c  ***  */ 

/*  ***  Generated:  Feb  8  10:13:45  1993  ***  */ 

«;tt4i*4<i|i:«c4i:t>4i«4>4<**>l"l>«*****>t>4»l<****4'4i4<****4i4<*4>*«**********4<'*>#««**«*********** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  Dtg 

These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_Dtg.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

* 

*  For  the  panel  items: 

*  Message 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated...TAE 

*  iijti^i:liMi****************************************’l'**************************** 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_Dtg.h” 

/*  One  “include”  for  each  connected  panel  */ 

Id  DtgTarget,  DtgView,  Dtgid; 

/*  DtgDispatch  is  defined  at  the  end  of  this  file  *! 

*  Initialize  the  view  and  target  of  this  panel. 

*! 

FUNCTION  VOID  Dtg_lnitialize_Panel  (vmCoUection) 

Id  vmCoIlection; 

{ 

Id  Co_Find  0: 

DtgView  =  Co_Find  (vmCollection,  “Dtg_v”); 

DtgTarget  =  Co_Find  (vmCollection,  “Dtg_t”): 

} 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*1 

FUNCTION  VOID  Dtg_Create_Panel  (relativeWindow,  flags) 
Window  relativeWindow: 

COUNT  flags; 

( 

if  (Dtgid) 

printf  (“Panel  (Dtg)  is  already  displayed-Vj”); 
else 

Dtgid  =  Wpt_NewPanel  (Default_Display,  DtgTarget.  DtgView. 
relativeWindow.  DtgDispatch,  flags); 

I 


4'****<t'***4'«**4<>)>**************4<***4i***«*«**4>****4>4<**** ************ *<•>***** 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*/ 

FUNCTION  VOID  Dtg_Destroy_Panel  () 
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{ 

Wpt_PaneIErase(DtgId); 

Dtgld=0; 

I 


*  Connect  to  this  panel.  Create  it  or  chtinge  it’s  state. 

*/ 

FUNCTION  VOID  Dtg_Connect_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 

I 

if(Dtgld) 

Wpt_SetPanelState  (Dtgld,  flags); 
else 

Dtg_Create_Panel  (relativeWindow.  flags); 

I 


*  Handle  event  from  parameter;  Message 
*/ 

EVENT_H>  iNDLER  Message_Event  (value,  count) 
TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  */ 
if  (count  <=  0) 

;  /*  null  value  or  no  value  */ 

else  if  (s_equal  (value[0],  “OK”)) 

I 

Dtg_Destroy_Panel  (); 

1 

else  if  (s_equal  (value[0],  “Cancel”)) 

I 

Dtg_Destroy_Panel  (); 

} 

/*  End  generated  code  for  Connection  */ 
t 


struct  DISPATCH  DtgDispatch[)  =  ( 

I  “Message”,  Message_Event } , 

{ NULL,  NULL )  /*  terminator  entry  */ 

I; 
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/*  **■*•  TAE  Plus  Code  Generator  version  Tue  May  2o  14:13:27  EDT  1992  */ 

/*  ***  File:  pan_Dtg.h  ***  */ 

/*  Generated:  Jan  19  13:12:17  1993  ♦/ 

*  PURPOSE: 

*  Header  file  for  panel:  Dtg 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  Dtg 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  gencrated...TAE 
*/ 

#ifndef  I_PAN_Dtg  /*  prevent  double  include  */ 

#defineI_PAN_Dtg  0 

/*  Vm  objects  and  panel  Id.  V 
extern  Id  DtgTarget,  DtgView,  Dtgld; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  DtgDispatch[]; 

/*  Initialize  DtgTargCi  and  DtgView  */ 
extern  VOID  Dtg_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  Dtg_Create_Panel  (); 

/•  Destroy  this  panel  and  erase  it  from  the  screen  ’•'/ 
extern  VOID  Utg_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  ♦/ 
extern  VOID  Dtg_Connect_Pane!  (); 

#endif 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_LackData.c  ***  */ 

/*  ♦**  Generated:  Feb  8  10: 13:45  1993  ***  */ 

l*i  ^^^n^^^^‘**^^***^^********^^********^^i^^*******^^*******************’¥**^^**^^****i^** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  LackData 

*  These  routines  enable  panel  initialization,  creation,  and  destruction, 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_LackData.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id.  Target,  and  View  are  provided. 

% 

*  For  the  panel  items: 

*  Message 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated... TAE 
*1 

#include  “taeconfinp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  ■pan_LackData.h” 

/*  One  “include"  for  each  connected  panel  */ 

Id  LackDataTarget,  LackDataView,  LackDatald; 

I*  LackDataDispatch  is  defined  at  the  end  of  this  file  */ 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  LackData_Initialize_Panel  (vmCollection) 

Id  vmCollection: 

I 

Id  Co_Find  (); 

LackDataView  =  Co_Find  (vmCollection,  "LackData_v’’): 

LackDataTiu'get  =  Co_Find  (vmCollection,  “LackData_t”); 

} 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*1 

FUNCTION  VOID  LackDaia_Create_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  nags; 

I 

if  (LackDatidd) 

printf  (“Panel  (LackData)  is  already  di.splayed.'Vi"); 
else 

LackDatald  =Wpt_NewPanel  (Default_Display,  LackDataTarget. 
LackDataView.  relativeWindow,  LackDataDispatch.  flags); 

I 


*  Erases  a  p;inel  from  the  screen  and  de-all(x:;»te  the  a.sstKiated  panel 

*  object. 

V 

FUNCTION  VOID  LackData_De.stroy_P;inel  () 

I 
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Wpt_PanelErase(LackDataId); 

LackDataId=0; 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

V 

FUNCTION  VOID  LackData_Connect_Pane!  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 

{ 

if  (LackDatald) 

Wpt_SetPanelState  (LackDatald,  flags); 
else 

LackData_Create_Panel  (relativeWindow,  flags); 

1 


y*  ^:t,^Ht,l,^it,*t^t**************************************************^i************ 

*  Handle  event  from  parameter;  Message 
*1 

EVENT_HANDLER  Message_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

1 

/*  Begin  generated  code  for  Connection  */ 
if  (count  <=  0) 

;  /*  null  value  or  no  value  */ 

else  if  (s_equal  (value[01,  “OK”)) 

I 

LackDaia_Destioy_Panel  (); 

I 

else  if  (s_equal  (valuefO],  “Cancel”)) 

I 

LackData_Destroy  Panel  (); 

I 


/*  End  generated  code  for  Connection  */ 

} 


struct  DISPATCH  LackDataDispatch[J  =  { 
r‘Message”.  Message_Event|, 

I  NULL,  NULL )  /*  terminator  entry  */ 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/*  ***  File:  pan_LackData.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  **♦  */ 

*  PURPOSE: 

*  Header  file  for  panel:  LackData 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  LackData 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated... TAE 
*/ 

#ifndef  I_PAN_LackData  f*  prevent  double  include  */ 

#define  I_PAN_LackData  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  LackDataTarget,  LackDataView.  LackDatald; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  LackDataDispatch[); 

/*  Initialize  LackDataTarget  and  LackDataView  */ 
extern  VOID  LackData_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  LackData_Create_Panel  0: 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  LackData_Destroy_Panel  (): 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  Lacli)ata_Connect_Panel  (); 

#endif 
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I*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/*  ***  File:  pan_NewBG.c  ***  */ 

/*  ***  Generated:  Jan  19  1 1:14:17  1993  ***  */ 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  NewBG 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_NewBG.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_NewBG.h” 


/*  One  “include”  for  each  connected  panel  */ 
#include  “pan_BGShips.h” 


/*BERN*/ 

#include 

#include 

#include 


“pan_LackData.h” 

“pan_SetUpBGs.h” 

“pan_SaveNewB.h” 


/♦BERN*/ 

extern  int  GetBGsO; 

extern  int  MakeBGO; 

extern  void  SaveBGsO: 


int 


SaveFlag  =  0; 


Id  NewBGTarget,  NewBGView,  NewBGId; 

/*  NewBGDispatch  is  defined  at  the  end  of  this  file  */ 

y*  *«***4c*«*******««**««4i4i****»**4i«*«:***i|i4t4i4i**4>4>***************»*********** 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  NewBG_lnitialize_Panel  (vmCoUection) 

Id  vmCollcction; 

I 

Id  Co_Find  (): 


NewBGView  =  Co_Find  (vmCollection,  “NewBG_v”); 
NewBGTarget  =  Co_Find  (vmCollection,  “NewBG_t’'); 
I 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  NewBG_Creale_PaneI  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

I 

if  (NewBGId) 

printf  (“Panel  (NewBG)  is  already  displayed.Nn”); 
else 

NewBGId  =  Wpt_NewPanel  (Default_Display,  NewBGTargctJ9ewBGView, 
relativeWindow,  NewBGDi.spatch,  flags); 

1 
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i 

I 

1  y*  *♦****♦♦♦****♦♦*♦♦♦**********♦**♦**♦♦♦***♦*♦*♦**♦•♦**♦*♦♦♦*************♦ 

I  *  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

I  *! 

FUNCTION  VOID  NewBG_Destroy_Panel  () 

^  *  I 

Wpt_PaneIErase(NewBGId); 

NewBGId=0; 

) 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

V 

FUNCTION  VOID  NewBG_Connect_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

{ 

if  (NewBGId) 

Wpt_SetPanelState  (NewBGId,  flags); 
else 

NewBG_Create_Panel  (relativeWindow,  flags); 

} 

*  Handle  event  from  parameter;  Close 
♦/ 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  ‘value!];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  •/ 

{ 

if  (SaveFlag  ==  1)| 
f*  Begin  default  generated  code  •/ 

NewBG_Destroy_Panel  (); 

/•  End  generated  code  for  Connection  */ 

I  else  ( 

SaveNewB_Connect_Panel(NULL.  WPT_PREFERRED); 


*  Handle  event  from  parameter:  Help 
*1 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  •/ 

FUNINT  count;  /*  num  of  values  */ 


*  Handle  event  from  parameter:  Save 
*/ 

EVENT_HANDLER  Save_Event  (value,  count) 
TEXT  ‘valued;  /*  string  pointers  ‘/ 

FUNINT  count;  f*  num  of  values  ‘/ 


BGInfo  BGsIMAXBGSj; 

int  BGIndex; 
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BGIndex 


=  GetBGs(BGs); 


if  {MakeBG(BGs,BGlndex,StringPann(NewBGTargel,"Name"), 
StringPann(NewBGTarget,”Designation”). 

RealParm  (NewBGTarget,TuelRes’’), 

RealParm  (NewBGTarget,”CLFFuelRes”), 

RealParm  (NewBGTarget/’OrdRes”), 

RealParm  (NewBGTarget,”CLFOrdRes”). 

RealParm  (NewBGTarget,”MaxF76”), 

RealParm  (NewBGTarget,”MaxF44”), 

RealParm  (NewBGTarget,”StationSpeed”), 

RealParm  (NewBGTarget,”UnrepSpeed”), 

RealParm  (NewBGTarget/’AcftShipSpeed”)))  ! 

SaveBGs(BGs); 

/*refresh  the  BGList  in  setupbgs  panel*/ 

BGIndex  =  GetBGs(BGs); 

ShowBGs(SelUpBGsId,”BGLisf’): 

SaveFlag  =  1 ; 

/*  Begin  generated  code  for  Connection  */ 
BGShips_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

)  else  { 

LackData_Connect_Panel(NULL,WPT_PREFERRED); 

1 


struct  DISPATCH  NewBGDispatch(]  =  ( 

(“Close”.  Close_Event}, 

{ “Help”.  Help_Event } , 

(“Save”.  Save_Eventi, 

{ NULL.  NULL  |  /*  terminator  entry  */ 

1; 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_NewBG.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  *! 

jit  ♦**********************************#*****************************^****:^* 

*  PURPOSE: 

*  Header  file  for  panel:  NewBG 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  NewBG 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 

*  *****************************************************+******************** 
*/ 

#ifndef  I_PAN_NewBG  /*  prevent  double  include  */ 

#define  I_PAN_NewBG  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  NewBGTarget,  NewBGView,  NewBGId: 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  NewBGDispatch[]; 

/*  Initialize  NewBGTarget  and  NewBGView  ’•'/ 
extern  VOID  NewBG_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  NewBG_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  NewBG_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  NewBG_Connect_Panel  (); 

#endif 
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f*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_SaveNewB.c  ***  */ 

/*  ***  Generated:  Feb  8  10:13:45  1993  ***  */ 

I*  ***m’t‘****^’*int**m*m************************^************^**************** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  SaveNewB 

These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  *#include  “pan_SaveNewB.h”'.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id.  Target,  and  View  are  provided. 

4( 

*  For  the  panel  items: 

*  Message 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated...TAE 
*/ 


#include 

“taeconfinp" 

#include 

“wptinc.inp” 

#include 

“global.h”  /*  Application  globals  */ 

“pan_SaveNewB.h” 

#include 

/♦BERN*/ 

#include 

"pan_SetUpBGs.h'’ 

#include 

“pan_BGShips.h’' 

#include 

“pan_NewBG.h" 

#include 

“pan_LackData.h'’ 

extern 

int  SaveNewBGO: 

Id  SaveNewBTarget,  SaveNewBView,  SaveNewBId: 

/*  SaveNewBDispatch  is  defined  at  the  end  of  this  file  */ 

♦  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  SaveNewB_lnitialize_Panel  (vmCollection) 
Id  vmCollection; 

{ 

Id  Co_Find  0: 

SaveNewBView  =  Co_Find  (vmCollection,  "SaveNewB_v”); 
SaveNewBTarget  =  Co_Find  (vmCollection,  “SaveNewBj”); 
} 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

fTJNCTION  VOID  SaveNewB_Create_PaneI  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 


if  (SaveNewBId) 

printf  (“Panel  (SaveNewB)  is  already  displayed.Nn”); 
else 

SaveNewBId  =  Wpt_NewPanel  (Default_Display. 
SaveNewBTarget.SaveNewBView,  relativeWindow. 
SaveNewBDispatch,  flags); 

I 
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*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*1 

FUNCTION  VOID  SaveNewB_Destroy_Panel  () 

I 

Wpt_PanelErase(SaveNewBId); 

SaveNewBId=0: 

1 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

V 

FUNCTION  VOID  SaveNewB_Connect_Panel  (lelativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 

I 

if  (SaveNewBId) 

Wpt_SetPanelStaie  (SaveNewBId,  flags); 
else 

SaveNewB_Create_Panel  (relativeWindow,  flags); 

} 


*  Handle  event  from  parameter:  Message 
*1 

EVENT_HANDLER  Message_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/♦BERN*/ 

int  BGIndex; 

BGInfo  BGslMAXBGS]; 

/*  Begin  generated  code  for  Connection  */ 

if  (count  <=  0) 

;  /*  null  value  or  no  value  */ 

else  if  (s_equal  (valuefOJ,  "OK”)) 

{ 

if  (SaveNewBG(NewBGTarget)  ==  I){ 

BGIndex  =  GetBGs(BGs); 
ShowBGs(SetUpBGsId,”BGList”); 
BGShips_Connect_Panel  (NULL,  WPT_PREFERRED); 
SaveNewB_Destroy_Panel  (); 

)  else  { 

SaveNewB_Destroy_Panel  (); 
LaclcData_ConnecLPanel(NULL,WPT_PREFERRED); 

1 
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else  if  (s_equal  (value(0],  “Cancel”)) 

I 

NewBG_Destroy_Panel(); 

SaveNewB_Destroy_Panel  (); 

1 

/*  End  generated  code  for  Connection  */ 

t 


struct  DISPATCH  SaveNewBDispatch[]  =  \ 

( “Message”,  Message_Event  | , 
i  NULL,  NULL )  /*  terminator  entry  */ 

1: 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14;13;27  EDT  1992  ***  */ 

/*  ***  File:  pan_SaveNewB.h  ***  ’"/ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

j*  m******’>i********^**^A‘**^*******iHt^f*^*^i***********m*******^****^t********* 

*  PURPOSE: 

*  Header  file  for  panel:  SaveNewB 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  SaveNewB 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated.. .TAE 
*/ 

#ifndef  l_PAN_SaveNewB  /*  prevent  double  include  */ 

#define  l_PAN_SaveNewB  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  SaveNewBTarget,  SaveNewBView,  SaveNewBld: 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  SaveNewBDispatch[l; 

/*  Initialize  SaveNewBTarget  and  SaveNewBView  */ 
extern  VOID  SaveNewB_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  SaveNewB_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  SaveNewB_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  .state  */ 
extern  VOID  SaveNewB_Connect_Panel  (); 

#endif 
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/•  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_SelBG.c  ***  */ 

/*  •**  Generated:  Feb  8  10:13:45  1993  *♦*  */ 

^^mm********************************************************** ********** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  SelBG 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_SelBG.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided, 

* 

*  For  the  panel  items: 

*  Message 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated...TAE 

*  ^i^i^^t^mitt^im***************************************************************** 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_SelBG.h” 

/*  One  “include”  for  each  connected  panel  */ 

Id  SelBGTarget,  SelBGView,  SelBGId; 

/*  SelBGDispatch  is  defined  at  the  end  of  this  file  */ 

I*  ******1^:***************************************************************** 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  SeIBG_Initialize_Panel  (vmCollection) 

Id  vmCollection; 

I 

Id  Co_Find  O'. 

SelBGView  =  Co_Find  (vmCollection,  “SelBG_v”); 

SelBGTarget  =  Co_Find  (vmCollection,  “SeIBG_t”); 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*1 

njNCTlON  VOID  SeIBG_Create_Panel  (relativeWindow,  flags) 

Window  relativeWindow; 

COUNT  flags; 

I 

if  (SelBGId) 

printf  (“Panel  (SelBG)  is  already  displayed.^n”); 
else 

SelBGId  =  Wpt_NewPanel  (Default_Display,  SelBGTarget,  SelBGView, 
relativeWindow,  SelBGDispatch,  flags); 

1 


I*  ************************************************************************ 

*  Erases  a  panel  from  the  screen  and  de-alliKate  the  associated  panel 

*  object. 


FUNCTION  VOID  SelBG_Destroy_Panel  () 

{ 

Wpt_PaneIErase(SeiBGId); 

SelBGId=0; 

I 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  SelBG_Connect_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  nags; 

{ 

if(SelBGId) 

Wpt_SetPanelState  (SelBGId,  flags); 
else 

SelBG_Create_Panel  (relativeWindow.  flags); 

I 


*  Handle  event  from  parameter:  Message 

V 

EVENT_HANDLER  Message_Event  (value,  count) 
TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  */ 
if  (count  <=  0) 

:  /*  null  value  or  no  value  */ 

else  if  (s_equal  (value[0],  “OK”)) 

I 

SelBG_Destroy  Panel  (); 

) 

else  if  (.s_equal  (valuefO),  “Cancer’)) 

I 

SelBG_Destroy_Panel  (); 

1 


[*  End  generated  code  for  Connection  */ 


struct  DISPATCH  SelBGDispatch[]  =  | 

{ “Mes.sage".  Me.s.sage_Event ) . 

( NULL.  NULL  1  /*  terminator  entry  */ 


1X1 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  ED'i  i'^92  ***  */ 
/*  ***  File:  pan_SelBG.h  ***  */ 

/♦  *♦*  Generated:  Jan  19  13:12:17  1993  *** 

*  PURPOSE: 

*  Header  file  for  panel:  SelBG 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  u.  c.is  file: 

*  The  panel's  name  is  changed  (not  title) 

*  For  panel: 

*  SelBG 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*/ 

#ifndef  I_PAN_SelBG  /*  prevent  double  include  */ 

#define  I_PAN_SelBG  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  SelBGTarget,  SelBGView,  SelBGId; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  SelBGDispatch[l; 

/*  Initialize  SelBGTarget  and  SelBGView  */ 
extern  VOID  SelBG_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  SelBG_Create_Panel  (); 

/♦  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  SelBG_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  SelBG_Connect_Panel  (); 

#endif 


1S2 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/*  **•  File:  pan_SetUpBGs.c  *♦*  */ 

/*  ***  Generated:  Jan  19  1 1:14^7  !1*************************** 

PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  SetUpBGs 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  lirom  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_SetUpBGs.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*  * 

*/ 


#include 

#include 

#include 

#include 


“taeconf.inp” 

“wptinc.inp” 

"global.h" 

“pan_SetUpBGs.h” 


f*  Application  globals  ♦/ 


/*  One  “include”  for  each  connected  panel  *1 


#include 

#include 

#include 

#include 


“pan_CloseAll.h” 

“pan_DelBG.h” 

“pan_BGData.h’' 

“pan_NewBG.h’' 


/•BERN*/ 

#include 

#inciude 

extern 

extern 


“pan_SelBG.h” 

“pan_CloseAll.h” 

int  GetBGsO; 
void  ShowBGsO; 


Id  SetUpBGsTarget,  SetUpBGsView.  SetUpBGsld: 

/*  SetUpBGsDispatch  is  defined  at  the  end  of  this  file  */ 

I* 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  SetUpBGs_Initialize_Panel  (vmCollecUon) 

Id  vmCoUection; 

I 

Id  Co_Find  O'. 

SetUpBGsView  =  Co_Find  (vmCoUection.  “SetUpBGs_v”); 
SetUpBGsTarget  =  Co_Find  (vmCoUection,  “SetUpBGs_t”): 

♦  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  SetUpBGs_Create_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 

{ 


/•BERN*/ 

BGlnfo  BGs[MAXBGS]: 


if  (SetUpBGsld) 

printf  (“Panel  (SetUpBGs)  is  already  displayed.Nn”); 
else 

SetUpBGsld  =  Wpt_NewPanel(Default_Display. 
SetUpBGsTarget.SetUpBGsView.  relativeWindow, 


183 


SetUpBGsDispatch,  flags); 
GetBGs(BGs); 

ShowBGs(SelUpBGsld,”BGList”); 

I 


*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*1 

FUNCTION  VOID  SetUpBGs_Destroy_PaneI  () 

1 

Wpt_PanelErase(SetUpBGsId); 

SetUpBGsld=0; 


I*  *«*:ti4>*««it<*4<*>l<*4»l<****************4i'*<4>***>)>*«************ ************ ******* 

*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  SetUpBGs_Connect_Panel  (relativeWindow.  flags) 

Window  relativeWindow; 

COUNT  flags; 

{ 

if  (SetUpBGsId) 

Wpt_SetPanelState  (SetUpBGsId,  flags); 
else 

SetUpBGs_Create_Panel  (relativeWindow,  flags); 

I 

*  Handle  event  from  parameter:  Close 
*1 

EVENT.HANDLER  Close_Event  (value,  count) 

TEXT  *value[I:  /*  string  pointers  */ 

FUNINT  count:  /*  num  of  values  *1 

( 

/*  Begin  generated  code  for  Connection  */ 

CloseAlLConnect_Panel  (NULL,  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

I 


^*  ************************************************************************ 
♦  Handle  event  from  parameter:  Delete 
*/ 

EVENT_HANDLER  Delete_Event  (value,  count) 

TEXT  *value(J;  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/•BERN*/ 

if  (StringParm(SetUpBGsTarget,”BGList")  !=  NULL){ 

/*  Begin  generated  code  for  Connection  */ 

DelBG_Connect_Panel  (NULL,  WPT.PREFERRED); 

/•  End  generated  code  for  Connection  •/ 


)  el.se  I 

SelBG_Conncct_Panel(NULL.  WPT_PREFERRED); 

I 

} 


184 


*  Handle  event  from  parameter:  Edit 
*/ 

EVENT_HANDLER  Edit_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

i 

/♦BERN*/ 

if  (StringParm(SetUpBGsTarget.”BGList”)  !=  NULL)| 

/*  Begin  generated  code  for  Connection  */ 
BGData_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 


}  else  { 

SelBG_Connect_Panel(NULL.  WPT_PREFERRED): 


j*  4i*******4i«****4>**«***«***«*****4rs|<«4i*4i««*««***««*«**«4c*4,«*:tc«*4c* *«*«««**** 

*  Handle  event  from  parameter:  Help 
*/ 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

I 


***«*«***4i***«iti****»>**********«*4i***4i*«***********«***«****4<************ 

*  Handle  event  from  parameter;  New 
*/ 

EVENT_HANDLER  New_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  */ 

NewBG_Connect_Panel  (NULL.  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

1 


struct  DISPATCH  SetUpBGsDispatchQ  =  ( 

I  “Close".  Close_Event } . 

{“Delete”.  Delete_Event  | , 
j  “Edit”.  Edit_Event ) . 

{“Help”.  Help_Event|. 
i  “New”.  New_Event  1 , 

( NULL,  NULL  |  /*  terminator  entry  */ 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  *! 
I*  ***  File:  pan_SetUpBGs.h  ***  •/ 

/*  ***  Generated:  Jan  19  13:12:17  1993  *•*  V 

*  PURPOSE: 

*  Header  file  for  panel:  SetUpBGs 

*  REGENERATED: 

*  The  following  WorkBench  operadons  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  SetUpBGs 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*/ 

#ifndef  I_PAN_SetUpBGs  /*  prevent  double  include  */ 

#define  l_PAN_SetUpBGs  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  SetUpBGsTarget,  SetUpBGs  View,  SetUpBGsld; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  SetUpBGsDispatchU; 

/*  Initialize  SetUpBGsTarget  and  SetUpBGsView  */ 
extern  VOID  SetUpBGs_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  SetUpBGs_Create_PaneI  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  SetUpBGs_Destroy_Panel  (): 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  SetUpBGs_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_Ship.c  ***  */ 

/*  **•  Generated:  Feb  8  10:40:35  1993  *♦*  */ 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  Ship 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_Ship.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*  For  the  panel  items: 

*  Aircraft,  Close,  F44,  F76, 

*  Help,  Ordnance,  Print,  Save, 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated... TAE 
♦/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  i*  Application  globals  •/ 

#include  “pan_Ship.h" 

/*  One  “include”  for  each  connected  panel  */ 

#include  “pan_AcftLoad.h” 

#include  “pan_F44Fuel.h” 

#include  “pan_F76Fuel.h” 

#include  “pan_OrdSel.h” 

#include  “pan_PrinlJob.h” 

Id  ShipTarget,  ShipView,  Shipid; 

/*  ShipDispatch  is  defined  at  the  end  of  this  file  */ 

I*  it<«*«**«**«4>*«****«****4i****4<3«i***r**«4i***4i4i*4t**«**4i*«*******4<*4i******4i*««* 

*  Initialize  the  view  and  target  of  this  panel. 

*1 

FUNCTION  VOID  Ship_lnitialize_Panel  (vmCollection) 

Id  vmCollection; 

i 

Id  Co_Find  Q; 

ShipView  =  Co_Find  (vmCollection,  “Sliip_v”); 

ShipTarget  =  Co_Find  (vmCollection,  “Ship_t”): 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*1 

FUNCTION  VOID  Ship_Create_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 

I 

if  (Shipid) 

printf  (“Panel  (Ship)  is  already  displayed.Vi”); 
else 

Shipid  =  Wpt_NewPanel  (Default_Display,  ShipTarget,  ShipView, 
relativeWindow,  ShipDispatch,  flags); 
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!*  *^t***%****ii****ii****m**^t^***nnni^,^iiHi:ti*********************************im** 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*! 

FUNCTION  VOID  Ship_Destroy_Panel  () 

I 

Wpt_PanelErase(Shipld); 

Shipld=0; 

I 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  Ship_Connect_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 

I 

if(ShipId) 

Wpt_SetPanelState  (Shipid,  flags); 
else 

Ship_Create_Panel  (relativeWindow,  flags); 

1 


*  Handle  event  from  parameter;  Aircraft 
*1 

EVENT_HANDLER  Aircraft_Event  (value,  count) 

TEXT  *value(];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  generated  code  for  Connection  *1 
AcftLoad_Connect_Panel  (NULL,  WPT.PREFERRED); 
/*  End  generated  code  for  Connection  */ 

I 


*  Handle  event  from  parameter;  Close 
*/ 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  ’*'value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 
Ship_Destroy_Panel  (); 

/*  End  generated  code  for  Connection  */ 

I 


I*  iiiii******ii*:*:*m****^m’*******4:*i****m*****^************m********^m********** 

*  Handle  event  from  parameter;  F44 
*/ 

EVENT_HANDLER  F44_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  */ 

F44Fuel_Connect_Panel  (NULL.  WPT_PREFERRED); 
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/*  End  generated  code  for  Connection  ♦/ 


*  Handle  event  from  parameter:  F76 
*/ 

EVENT_HANDLER  F76_Event  (value,  count) 

TEXT  *valuet];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

f*  Begin  generated  code  for  Connection  */ 
F76FueI_Connect_PaneI  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

1 


I*  i|<««4i«**s|iiti4<i|<4<*4>t<****4<4i«*******4i*«*^*«:|<««******«4c4<«%,ti***:tt****4i4<'l>********** 

*  Handle  event  from  parameter:  Help 

V 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

1 


y4t 

*  Handle  event  from  parameter;  Ordnance 
*/ 

EVENT_HANDLER  Ordnance_Event  (value,  count) 
TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 
OrdSel_Connect_PaneI  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  •/ 

} 


*  Handle  event  from  parameter:  Print 
*/ 

EVENT_HANDLER  Print_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  •/ 

{ 

/*  Begin  generated  code  for  Connection  */ 
PrinUob_Connect_Panet  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 


jm  ********************* *4i4'*****4i4<4i**4>***************** *****41  **:ti*** ******4, 

*  Handle  event  from  parameter:  Save 
*/ 

EVENT_HANDLER  Save_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count:  /*  num  of  values  */ 

{ 

} 
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stnict  DISPATCH  ShipDispatchl]  =  ( 

(“Aircraft”,  Aircraft_Event}, 

I  “Close”,  Close_Event } , 

{“F44”,F44_Event|, 

{“F76”,F76_Eventl, 

{ “Help”,  HeIp_Event  | , 

(“Ordnance”,  Ordnance_Eventl, 

( “Print”,  Print_Event ) , 

(“Save”,  Save_Eventi, 

( NULL,  NULL  j  /*  terminator  entry  */ 

): 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/*  ***  File:  pan_Ship.h  ***  */ 

/*  ***  Generated:  Jan  19  13:12:17  1993  ***  */ 

*  PURPOSE: 

*  Header  file  for  panel:  Ship 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  Ship 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*1 

#ifndef  I_PAN_Ship  /*  prevent  double  include  */ 

#define  I_PAN_Ship  0 

/*  Vm  objects  and  panel  Id.  */ 
extern  Id  ShipTarget,  ShipView,  Shipid; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  ShipDispatch[]; 

/*  Initialize  ShipTarget  and  ShipView  */ 
extern  VOID  Ship_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  Ship_Create_Panel  (): 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  Ship_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  Ship_Connect_Panel  (); 

#endif 
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/•  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  •/ 
/*  ***  File:  BGEvents.c  •/ 

/*  ***  Generated:  Jan  19  09:08:04  1993  ***  *! 

*  PURPOSE: 

*  This  the  main  program  of  an  application  generated  by  the  TAE  Plus  Code 

*  Generator. 

* 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

* 

*  NOTES: 

*  To  turn  this  into  a  real  application,  do  the  following: 

* 

*  1 .  Each  panel  that  has  event  generating  parameters  is  encapsulated  by 

*  a  separate  file,  named  by  concatenating  the  string  ‘‘pan_"  with  the 

*  panel  name  (followed  by  a  “.c”).  Each  parameter  that  you  have  defined 

*  to  be  “event-generating",  has  an  event  handler  procedure  in  the 

*  appropriate  panel  file.  Each  handler  has  a  name  that  is  a 

*  concatentation  of  the  parameter  name  and  the  string  “_Event".  .Add 

*  application-dependent  logic  to  each  event  handler.  (As  generated  by 

*  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of  the 

*  event.) 

* 

*  2.  To  build  the  program,  type  “make".  If  the  symbols  TAEINC . 

*  are  not  defined,  the  TAE  shell  (source)  scripts  STAE/bin/csh/taesetup 

*  will  define  them. 

*  ADDITIONAL  NOTES: 

*  1 .  Each  event  handler  has  two  .u'gument.s:  (a)  the  value  vector 

*  associated  with  the  parameter  and  (b)  the  number  of  components.  Note 

*  that  for  scalar  values,  we  pass  'ne  value  as  if  it  were  a  vector  with 

*  count  1. 

* 

*  Though  it's  unlikely  that  you  are  interested  in  the  value  of  a  button 

*  event  parameter,  the  values  are  always  passed  to  the  event  handler  for 

*  consistency. 

* 

*  2.  You  gain  access  to  non-event  parameters  by  calling  the  Vm  package 

*  using  the  targetid  Vm  objects  that  are  created  in 

*  lnitialize_All_Panels.  There  are  macros  defined  in  global.h  to  assist 

*  in  accessing  values  in  Vm  objects. 

* 

*  To  access  panel  Id,  target,  and  view,  of  other  panels,  add  an 

*  “#include"  statement  for  each  appropriate  panel  header  file. 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated...TAE 
*/ 

#include  “taeconf.inp" 

#include  “wptinc.inp” 

#include  “symtab.inc” 

#include  “global.h"  /*  Application  globals  */ 

Display  *Default_Di.splay; 

BOOL  Application_Done  =  FALSE; 

main  (argc,  argv) 
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FUNINT  argt; 

TEXT  *argvi’, 

( 

WptEvent  wptEvent;  /*  event  daui  */ 

rODE  evenlType; 

COUNT  termLines,  termCols; 

CODE  tennTypey*BERN*/rei; 

f*  PROGRAMMER  NOTE; 

*  add  similar  extern’s  for  each  resource  file  in  this  application 
*/ 

extern  VOID  BGEvents_Initialize_AIl_Pane!s  (); 
extern  VOID  BGEvents_Create_Initial_Panels  (): 

struct  DISPATCH  *dp;  /*  working  dispatch  pointer  */ 

IMPORT  struct  VARIABLE  ♦Vm_Find(); 

struct  VARIABLE  *pannv;  /*  pointer  to  event  VARIABLE  */ 

[*  initialize  terminal  without  clearing  screen  */ 
t_pinit  (&terinLines.  AtermCols,  AtemiType); 

/*  permit  upper/lowercase  file  names  */ 
f_force_lower  (FALSE); 

Default_Display  =  Wpt_Init  (NULL); 

!*  initialize  resource  file  */ 

/*  PROGRAMMER  NOTE; 

*  For  each  resource  file  in  this  application,  calls  to  the  appropriate 

*  lnitialize_All_Panels  and  Create  lnitial_Panels  must  1^  added. 

*/ 

BGEvents_Initialize_All_Panels  (“/h/bglcss/scripts/gui/events/BGEvents.res"); 
BGEvents_Create_Initial_Panels  (); 

/*BERNV 

ret  =  Wpt_SetHelpStyle  (“wpthelp.res"); 
if  (ret  !=  SUCCESS) 
printf(“Couldn’t  set  help  styleW); 

/*  main  event  loop  */ 

/•  PROGRAMMER  NOTE; 

*  use  SET_APPLICATION_IX)NE  in  "quit”  event  handler  to  exit  lot)p. 

*  (SET_APPL1CAT10N_D0NE  is  defined  in  global.h) 

*/ 

while  (!Application_Done) 

i 

eventType  =  Wpt_Next£vent  (&wptEvent);  f*  get  next  WPT  event  */ 

switch  (eventType) 

I 

case  WPT_PARM_EVENT; 

/*  Event  has  occurred  from  a  Panel  Parm.  Lookup  the  event 

*  in  the  dispatch  table  and  call  the  associated  event 

*  handler  function. 

*/ 

dp  =  (struct  DISPATCH  *)  wptEvent.p_usciContcxt; 
for(;  (*dp).pannName  !=  NULL;  dp++) 
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if  {s_equal  ((*dp).parmName,  wptEvent.parmNanie)) 

I 

parmv  =  Vm_Find  (wptEvent.p_dataVm,  wptEvent.pannName); 
(*(*dp).eventFunclion) 

((*pamiv).v_cvp,  ('''pannv).v_count); 
break; 

) 

break; 

case  WPT_FILE_EVENT: 

/*  PROGRAMMER  NOTE; 

*  Add  code  here  to  handle  file  events. 

*  Use  Wpt_AddEvent  and  Wpt_RemoveEvent  to  register  and  remove 

*  event  sources. 

*i 

printf  (“No  EVENT_HANDLER  for  event  from  external  source.Nn"); 
break; 

case  WPT_WINDOW_EVENT: 

/*  PROGRAMMER  NOTE; 

*  Add  code  here  to  handle  window  events. 

*  WPT_WINDOW_EVENT  can  be  caused  by  windows  which  you  directly 

*  create  with  X  (not  TAE  panels),  or  by  user  acknowledgement 

*  of  a  Wpt_PanelMessage  (therefore  no  default  print  statement 

*  is  generated  here). 

*/ 

break; 

case  WPT_TIMEOUT_EVENT; 

/*  PROGRAMMER  NOTE; 

*  Add  code  here  to  handle  timeout  events. 

*  Use  Wpt_SetTimeOut  to  register  timeout  events. 

V 

printf  (“No  EVENT_HANDLER  for  timeout  event.Vi”); 
break; 

default: 

printff'Unknown  WPT  Event\n”); 
break; 

I 

I  /*  end  main  event  loop  */ 

Wpt_Finish():/*  close  down  all  display  connections  */ 
f*  PROGRAMMER  NOTE: 

*  Application  has  ended  normally.  Add  application  specific  code  to 

*  close  down  your  application 
*1 

}  /♦  end  main  */ 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  BGEvents_creat_init.c  ***  */ 

/*  ***  Generated:  Jan  i9  09:08:04  1993  ♦**  */ 

*  PURPOSE: 

*  Displays  all  panels  in  the  initial  panel  set  of  this  resource  file 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  fde: 

*  A  panel  is  added  to  the  initial  p^el  set 

*  A  panel  is  deleted  from  the  initial  panel  set 

*  For  the  set  of  initial  panels: 

*  BGEvents 

* 

*  CHANGE  LOG: 

*  19-Jan-93  Initially  generated.. .TAE 

4c  4c4c4c4i4c4c4c4>4c**4c4c4c4t*4c*4c4c4t4c4c4c4c4c4c4c4c4c4c4c4c4c4c4t«4t4t4t«**4c4c4c4c4c4c«*4c4c4c4t*«4c4(4c«4c4(4c*4c4c4c4c4c4c4c 

V 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  f*  Application  globals  *1 

/*  One  include  for  each  panel  in  initial  panel  set  */ 

#include  '‘pan_BGEvents.h” 


FUNCTION  VOID  BGEvents_Cteate_InitiaI_Panels  () 

I 

/*  Show  panels  */ 

BGEvents_Create_Panel  (NULL,  WPT_PREFERRED); 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  *♦*  */ 

/*  ***  File:  BGEvents_init_pan.c  ***  */ 

/*  ***  Generated:  Feb  5  14:09:32  1993  V 

*  PURPOSE: 

*  Initialize  all  panels  in  the  resource  file. 

m 

*  REGENERATED: 

*  The  following  WoricBench  operations  will  cause  regeneration  of  this  fde: 

*  A  panel  is  deleted 

*  A  new  panel  is  added 

*  A  panel's  name  is  changed  (not  title) 

*  For  the  panels: 

*  AAWThret,  Aircraft.  AirData,  ASW,  ASWOrd.  ASWThret,  BGCrsSpd, 

*  BGEvents,  BGShips,  BGSSCom,  BGSumCom.  Close  All,  CommentL,  CommList. 

*  Consol,  ConsolDa.  ConsolRe,  DelAcft,  DelComm.  DelEvent,  DelOrd, 

*  DelShip,  Dtg.  EditComm,  EventLis.  F44Fuel,  F76Fuel.  FuelTran. 

*  LatLong,  OrdData,  Ordnance,  OrdTrans,  OrdTrSel,  PrintJob,  Raid. 

*  RaidShip,  SelBG,  SelOrd,  SelShiOr,  SelShip.  SelSumm,  SetStati, 

*  ShCrsS^,  Ship,  Shuttle,  StatRes,  Strike,  StrikeSh,  Unrep. 

*  UnrepDat,  UniepRes,  USumComm.  USumOrd 

* 

*  CHANGE  LOG: 

*  5-Feb-93  Initially  generated...TAE 

*  «:ti*4i***4c****4<****4<**«*«*4<«*«4<*******4t************4i****4i**«*:4<***4i*****4>*« 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “symtab.inc" 

#include  “global.h”  /*  Application  globals  •/ 

/*  One  “include”  for  each  panel  in  resource  file  */ 

#include  “pan_AAWirbret.h” 

#include  “pan_Aircraft.h” 

#include  “pan_AirData.h” 

#include  “pan_ASW.h” 

#include  “pan_ASWOrd.h'’ 

#include  “pan_ASWThret.h” 

#include  “pan_BGCrsSpd.h” 

#include  "pan_BGEvents.h” 

#include  "pan_BGShips.h” 

#include  “pan_BGSSCom.h” 

#include  "pan_BGSumCom.h” 

#include  "pan_CloseAll.h” 

#include  "pan_CommentL.h” 

#include  ■■pan_CommList.h” 

#include  “pan_Consol.h” 

#include  ■•pan_ConsolDah” 

#include  “pan_ConsolRe.h” 

#include  "pan_DelAcft.h” 

#include  “pan_DelComm.h" 

#include  “pan_DelEvent.h” 

#include  "pan_DelOrd.h” 

#include  "pan_DelShip.h” 

#include  “pan_Dtg.h” 

#include  “pan_EditComm.h” 

#include  “pan_EventLis.h” 

#include  “pan_F44Fuel.h" 

#include  “pan_F76Fuel.h" 

#include  “pan_FuelTran.h” 
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#mclude  “pan_LatLong.h" 

#inciude  “pan_OrdData.h” 

#include  “pan_Ordnance.h'’ 

#include  “pan_C)rdTrans.h’' 

#include  “pan_OrdTrSel.h’' 

#include  “pan_PrintJob.h" 

#mclude  “pan_Raid.h” 

#mclude  “pan_RaidShip.h” 

#include  “pan_SelBG.h” 

#include  “pan_SelOrd.h” 

#include  “pan_SelShiOr.h’’ 

#include  “pan_SelShip.h” 

#include  “pan_SelSumm.h” 

#include  '‘pan_SetStati.h” 

#include  “paji_ShCrsSpd.h” 

#include  “pan_Ship.h” 

#include  “pan_Shuttle.h” 

#include  “pan_StatRes.h” 

#include  “pan_Strike.h” 

#include  '‘pan_StrikeSh.h” 

#include  “pan_Uiirep.h” 

#include  ■‘pan_UnrepDal.h” 

#include  “pan_UiirepRes.h" 

#include  ”pan_USuinComm.h” 

#include  “pan_USumOrd.h’' 


FUNCTION  VOID  BGEvents_Irutialize_All_PaneIs  (resfileSpec) 
TEXT  *resfUeSpec; 

( 

extern  Id  Co_Find  (); 
extern  Id  Co_New  0; 

Id  vmCoUection : 

/*  read  resource  file  */ 
vmCoUection  =  Co_New  (P_ABORT); 

Co_ReadFile  (vmCoUection,  resfileSpec.  P_ABORT): 

f*  initialize  view  and  target  Vm  objects  for  each  panel  */ 
AAWThret_Initialize_PaneI  (vmCoUection); 
Aircraft_Initialize_PaneI  (vmCoUection); 
AirData_Initialize_Panel  (vmCoUection); 
ASW_lnitialize_Panel  (vmCoUection); 
ASWOrd_InitiaUze_Panel  (vmCoUection); 
ASWThret_lnitialize_Panel  (vmCoUection); 
BGCrsSpd_Initialize_Panel  (vmCoUection); 
BGEvents_Initialize_Panel  (vmCoUection); 
BGShips_Initialize_Panel  (vmCoUection); 
BGSSCom_Initialize_Panel  (vmCoUection); 
BGSumCom_Initialize_Panel  (vmCoUection); 
CloseAU_InitiaUze_Panel  (vmCoUection); 
CommentL_Initialize_Panel  (vmCoUection); 
CommList_Initialize_Panel  (vmCoUection); 
Consol_lnitialize_Panel  (vmCoUection); 
ConsolDaJnitialize_Panel  (vmCoUection); 
ConsoU^e_lnitialize_Panel  (vmCoUection); 
DelAcft_InitiaUze_Panel  (vmCoUection); 
DelComm_Initialize_Panel  (vmCoUection); 
DelEvent_Initialize_Panel  (vmCoUection); 
DelOrd_Initialize_Panel  (vmCoUection); 
DelShip_Initialize_PaneI  (vmCoUection); 
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Dtg_Initia)jze_PaneI  (vmCoUection); 
EditComm_lnitialize_Panel  (vmCollection); 
EventLis_Initialize_Panel  (vmCollection); 
F44FueLlnitialize_Panel  (vmCollection); 
F76Fuel_Initialize_Panel  (vmCollection); 
FuelTran_Initialize_PaneI  (vmCollection); 
LatLong_lnitialize_Panel  (vmCollection); 
C)rdData_lnitialize_Panel  (vmCollection); 
C)rdnance_lnitialize_PaneI  (vmCollection); 
OrdTrans_lnitialize_Panel  (vmCollection); 
C)rdTrSel_Initialize_Panel  (vmCollection); 
PrintJob_Initialize_Panel  (vmCollection); 
Raid_lnitialize_Panel  (vmCollection); 

Raids  hip_lnitialize_Panel  (vmCollection); 
SelBG_initialize_Panel  (vmCollection); 
SelOrd_Initialize_Panel  (vmCollection); 
SelShiOr_Initialize_PaneI  ( vmCollection); 
SelShip_Initialize_Panel  (vmCollection); 
SelSumm_Initialize_Panel  (vmCollection); 
SetStati_Initialize_Panel  (vmCollection); 
ShCrsSpd_lnitialize_Panel  (vmCollection); 
Ship_Initialize_Panel  (vmCollection); 
Shuttle_Initialize_Panel  (vmCollection); 
StatRes_lnitialize_Panel  (vmCollection); 
Strike_Initialize_Panel  (vmCollection); 
StrikeSh_lnitialize_Panel  ( vmCollection); 
Unrep_Initialize_Panel  (vmCollection); 
UnrepDat_lnitialize_Panel  (vmCollection); 
UnrepRes_lnitiali2e_Panel  (vmCollection); 
US  umComm_Initialize_Panel  ( vmCollection) 
USumC)rd_lnitialize_Panel  (vmCollection); 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

I*  ***  File:  Imakefile  ***  ♦/ 

/*  *♦*  Generated:  Jan  13  1 1:28:36  1993  ***  */ 

y*  *4<4»l>**4<*********>|c*i|i*********4>*4>*<l>*4i****«***4i*4i*4[*****:ti**«******««*>)i***** 

*  PURPOSE: 

*  This  is  the  Imakefile  of  a  C  application  generated  by  the  TAE  Plus 

*  Code  Generator. 

* 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

*  NOTES: 

*  1.  To  build  your  application,  type  “make”.  The  Makefile  generated 

*  by  the  TAE  code  generator  invokes  imake  using  this  Imakefile  to 

*  generate  an  application  specific  Makefile. 

*  2.  If  you  change  the  name  of  your  resource  file  or  application,  you 

*  will  need  to  either  edit  this  file,  or  just  delete  it  and  regenerate 

*  the  code. 

* 

*  3.  Edit  this  file  to  include  your  application  specific  source  files. 

*1 

#define  GeneratedApplication 
/*  PROGRAMMER  NOTE: 

*  Add  a  line  '#include  “Imake.RESFILENAME”’  for  each  resource  file  in 

*  your  application. 

V 

#include  "Imake.BGEvents” 


/*  PROGRAMMER  NOTE: 

*  Insert  application  specific  build  parameters.  These  override 

*  definitions  in  the  configuration  files  in  STAE/config. 

*/ 

CDEBUGFLAGS  = 

LDDEBUGFLAGS  = 

APP_CFLAGS  = 

APP  lOAD  FI  AGS - 
APP.LINiaiBS  =  -L/h/Nauticus/libs  -IVids 
APP_DEPLIBS  =  $(DEPLIBS) 

APP_CINCLLJDES  =  -IS(TAEINC)\ 

-I/h/Nauticus/include/vidsA^ids.h\ 
-idi/bglcss/scripts/gui/events/BGEventsLib.h\ 
-I/h/bglcss/scripts/gui/event^g.h 
PROGRAM  =  BGEvents 

/*  PROGRAMMER  NOTE: 

*  Add  $(SRCS_RESFILENAME)  and  $(OBJS_RESFILENAME)  for  each  resource  file 

*  in  your  application. 

*/ 

GENSRCS  =  $(PROGRAM).c  $(SRCS_BGEvents) 

GENOBJS  =  $(PROGRAM).o  S(OBJS_BGEvents) 

/*  PROGRAMMER  NOTE: 

*  Add  your  application  specific  srcs  and  object  files  (that  are  not 

*  generated  by  the  code  generator)  here. 

*/ 

APPSRCS  =  /h/bglcss/scripts/gui/events/bg.c\ 
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/h/bglcss/scripts/gui/events/BGEventsLib.c 
APPOBJS  =  /h/bglcss/scripts/gui/events/bg.o\ 
/h/bglcss/scripts/gui/events/BGEventsLib.o 


/*  Macro  (defined  in  TAEmake.tinpl)  to  generate  Makefile  targets. 
*/ 

CApplication($(PROGRAM)) 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGCrsSpd.c  ***  */ 

/*  ***  Generated:  Jan  19  15:25:41  1993  **♦  */ 

*4i>|i3tt*4>***4i**4<«***4»l<<)<*4<**4i4'«4i*4<4<*<l<**«*********4<***4i*4<****«********4<«***** 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel;  BGCrsSpd 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_BGCrsSpd.h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

*1 

#inctude  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_BGCrsSpd.h” 

/*  One  “include”  for  each  connected  panel  */ 

#include  “pan_Dtg.h” 

/♦BERN*/ 

#include  “pan_SelBG.h” 

#include  “pan_BGEvents.h” 

/♦BERN*/ 

extern  BGEVENT*  SaveBGEventsO; 

extern  BGEVENT*  GelBGEvents(); 

extern  BGEVENT*  MakeBGEventO; 

extern  BGEVENT*  InsertBGEventQ; 

extern  int  GetBG(); 

extern  int  GetBGsO; 

extern  int  dtg(): 

extern  int  vtdiddtgO; 

extern  BGHEADER*  MakeBGHeader(): 

extern  BGHEADER*  GetBGHeadersO^ 

extern  BGHEADER*  InsertBGHeader(); 

extern  BGHEADER*  SaveBGHeadersO; 

Id  BGCrsSpdTarget.  BGCrsSpdView,  BGCrsSp^d: 

/*  BGCrsSpdDispatch  is  defined  at  the  end  of  this  file  */ 

y*  ^i*it%^m*******m************’^******************************************:*** 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  BGCrsSpd_Initialize_Panel  (vmCollection) 

Id  vmCollection; 

( 

Id  Co_Find  0: 

BGCrsSpdView  =  Co_Find  (vmCollection,  “BGCrsSpd_v”); 

BGCrsSpdTarget  =  Co_Find  (vmCollection,  “BGCrsSpdj”); 

} 


*  Create  the  panel  object  and  display  it  on  the  screen. 

*/ 

FUNCTION  VOID  BGCrsSpd_Create_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 
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if(BGCrsSpdld) 

printf  (“Panel  (BGCrsSpd)  is  already  displayed.\n”); 
else 

BGCrsSpdld  =  Wpt_NewPanel(DefauIt_Display,  BGCrsSpdTarget, 
BGCrsSpdView,  relativeWindow,  BGCrsSpdDispaich,  flags); 


*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object. 

*/ 

FUNCTION  VOID  BGCrsSpd_Destroy_Panel  () 

{ 

Wpt_PanelErase(BGCrsSpdId); 

BGCrsSpdId=0; 

} 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  BGCrsSpd_Connect_Panel  (reltUiveWindow,  flags) 
Window  relativeWindow; 

COUNT  flags: 

{ 

if  (BGCrsSpdld) 

Wpt_SetPanelState  (BGCrsSpdld,  flags); 
else 

BGCrsSpd_Create_Panel  (relativeWindow,  flags); 


y*  **«***4i;*«««*««*:***4i****4i««ac***4c«**4i4i**4i««****4i***4i*4>************4>******4t 

*  Handle  event  from  parameter;  AddEvent 
*/ 

EVENT_HANDLER  AddEvent_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 


I 

/♦BERN*/ 

BGInfo 

int 

int 

BGHEADER* 

BGHEADER* 

BGEVENT* 

BGEVENT* 


BGs[MAXBGSJ; 

BGIndex  =  0; 

BGHeaderIndex  =  0; 

NewHeader; 

HeadHeader; 

NewEvent; 

HeadEvent; 


HeadEvent  =  (BGEVENT*  )  malloc(sizeof  (struct  BGEvent )); 
HeadEvent->DTG  =  0; 


HeadHeader  =  (BGHEADER*  )  malloc(sizeof  (struct  BGHeader )); 
HeadHeader->DTG  =  0; 


BGIndex  =  GetBGs(BGs); 
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BGIndex  =  GetBG(StringPami(BGEventsTarget,’'BGList”).  BGIndex); 
HeadEvent  =  GetBGEvents(BGIndex); 
if  (HeadEvent->DTG  ==  0)| 

HeadEvent  =  (BGEVENT*  )  malioc(sizeof  (struct  BGEvent )); 

I 


NewEvent  =  MakeBGEvent(0,  dtg(StringPann(BGCrsSpdTarget,”Dtg”)), 
BGCourseSpeed,Orphan ,  All  J-o  w.  1  (X), 

RealParmfBGCrsSpdTarget, ’’Course”), 

RealParm(BGCrsSpdTarget.  “Speed”)); 

NewHeader=MakeBGHeader(BGCourseSpeed, 

StringParm(BGCrsSpdTarget,”Dtg”), 

RealPann(BGCrsSpdTarget,”Course”), 

RealParm(BGCrsSpdTarget,  “Speed”)); 

HeadHeader  =  GetBGHeaders(BG  Index); 

HeadHeader  =  InsertBGHeaderfHeadHeader,  NewHeader); 

SaveBGHeaders(BGIndex,  HeadHeader); 

HeadEvent  =  InsertBGEvent(HeadEvent.  NewEvent); 

SavcBGEvents(BGlndex,  HeadEvent); 

ffee(HeadEvent); 

free(NewEvent); 

I*  Begin  generated  code  for  Connection  */ 

BGCrsSpd_Destroy_Panel  (); 

t*  End  generated  code  for  Connection  */ 

I 


*  Handle  event  from  parameter;  Close 
*/ 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNTNT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 
BGCrsSpd_Destroy_Panel  (); 

I*  End  generated  code  for  Connection  */ 

} 


*  liandle  event  from  parameter;  Dtg 
*/ 

EVENT_HANDLER  Dtg_Event  (value,  count) 
TEXT  *value[];  /*  string  pointers  •/ 

FTJNINT  count;  f*  num  of  values  */ 

I 

int  Dtginteger; 
int*  pointer: 
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(int*)  Dtglntcger  =  pointer; 

Dtginteger  =  dtg(StringPann(BGCrsSpdTarget.  “Dtg”)); 

if  (validdtg((StringPann(BGCrsSpdTarget,  “Dtg”)),  pointer)  ==  0)| 

/*  Begin  generated  code  for  Connection  */ 

Dtg_Connect_Panel  (NULL,  WPT_PREreRRED); 

/*  End  generated  code  for  Connection  */ 

> 

1 

y*  **m*'l'*******‘^**’************•|l****^l********^i**^l^**^l^l*^i^l**^l*:>i^l^t^l^i*^*^,^^*m*** 

*  Handle  event  from  parameter;  Help 
*/ 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  ’''value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

I 


struct  DISPATCH  BGCrsSpdDispatch(]  =  | 

(“AddEvent”,  AddEvent_Event  | , 

{ “Close”,  Close_Event  | , 
i  “Dtg”,  Dtg_Event  ( , 

I  “Help”,  Help_Event}, 

( NULL,  NULL }  /*  terminator  entry  */ 
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/*  *’"*  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 
/♦  *•*  Pile;  pan_BGCrsSpd,h  */ 

/*  ***  Generated:  Jan  19  09:08:04  1993  ***  */ 

*  PURPOSE: 

*  Header  file  for  panel:  BGCrsSpd 

* 

*  REGENERATED: 

*  The  following  WoikBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  BGCrsSpd 

* 

*  CHANGE  LOG: 

19-Jan-93  Initially  generated...TAE 

*/ 

#ifndef  l_PAN_BGCrsSpd  /*  prevent  double  include  */ 

#define  I_PAN_BGCrsSpd  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  BGCrsSfxlTarget,  BGCrsSpdView,  BGCrsSpdId; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  *! 
extern  struct  DISPATCH  BGCrsSpdDispatchf]; 

I*  Initialize  BGCrsSpdTarget  and  BGCrsSpdView  */ 
extern  VOID  BGCrsSpd_Initialize_Panel  0; 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  BGCrsSpd_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  *! 
extern  VOID  BGCrsSpd_Destroy_Panel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  BGCrsSpd_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGEvents.c  ***  */ 

/*  ***  Generated:  Feb  8  11:33:14  1993  ***  */ 

^t^^it,***’*’****’¥**********»‘******iti**‘*******^i******************************* 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  BGEvenis 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_BGEvents,h”’.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id.  Target,  and  View  are  provided. 

* 

*  For  the  panel  items: 

*  AAWTTu'eatLevel,  ASWEvent,  ASWThreatLevel,  BGCourseSpeed, 

*  Close,  CommentList,  Consol,  EventList. 

*  FuelTransfer,  Help,  OrdnanceTransfe,  Predict. 

*  Raid.  SetStation,  ShipCourseSpeed,  ShipList, 

*  Strike,  Unrep 

* 

*  CHANGE  LOG: 

*  8-Feb-93  Initially  generated...TAE 
*/ 

#include  “taeconf.inp" 

#include  "wptinc.inp" 

#include  “global.h”  /*  Application  globals  */ 

#include  “pan_BGEvents.h” 

/*  One  “include”  for  each  connected  panel  */ 

#include  “pan_AAWThret.h” 

#include  "pan_ASW.h” 

#include  “pan_ASWThret.h” 

#include  “pan_BGCrsSpd.h” 

#include  “pan_CloseAll.h” 

#include  “pan_CommentL.h” 

#include  “pan_Consol.h” 

#include  “pan_EventLis.h” 

#include  “pan_FuelTran.h” 

#include  “pan_OrdTrSel.h” 

#include  “pan_SelSumm.h” 

#include  “pan_Raid.h” 

#include  “pan_SetStati.h” 

#include  “pan_ShCrsSpd.h” 

#include  "pan_BGShips.h” 

#include  “pan_Strike.h” 

#include  “pan_Unrep.h" 

/♦BERN*/ 

extern  int  GetBGsO; 

extern  void  ShowBGsO; 


Id  BGEventsTarget.  BGEventsView,  BGEventsId: 

/*  BGEventsDispatch  is  defined  at  the  end  of  this  file  */ 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  BGEvents_lnitialize_PaneI  (vmCollection) 
Id  vmCollection; 


Id  Co_Find  0: 

BGEvenlsView  =  Co_Find  (vmCollection,  “BGEvents_v"); 
BGEventsTarget  =  Co_Find  (vmCollection,  “BGEvents_t’'); 
I 


*  Create  the  panel  object  and  display  it  on  the  screen. 

V 

FUNCTION  VOID  BGEvents_Create_Panel  (relativeWindow.  flags) 

Window  relativeWindow; 

COUNT  flags; 

1 

/♦BERN*/ 

BGlnfo  BGs[MAXBGS|; 
if  (BGEventsId) 

printf  (“Panel  (BGEvents)  is  already  displayed.Vi“); 
else 

BGEventsId  =Wpt_NewPanel  (Default_Display,  BGEventsTarget,  BGEventsView, 
relativeWindow,  BGEventsDispatch,  flags); 

GetBGs(BGs); 

ShowBGsfBGt  'entsld,"BGList"); 


*  Erases  a  panel  from  the  screen  and  de-allocaie  the  associated  panel 

*  object. 

V 

FUNCTION  VOID  BGEvents_Destroy .Panel  {) 

( 

Wpt  PanelErase(BGEventsId); 

BGEventsld=0; 

1 


y*  *4i*4>*«********«***««***4i*«***«******4i*«**«*************«***********«***« 

•  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  BGEvents.Connect.Panel  (relativeWindow.  flags) 

Window  iclativeWindow; 

COUNT  flags; 

I 

if  (BGEventsId) 

Wpt_SeiP;inclStatc  (BGEventsId,  flags); 
else 

BGEvcni.s_Creale_Panel  (relativeWindow.  Hags); 


4i4i**4i>*i4(4(4t*4i«t’*t>li*4t4i4t4i4t*4  4i4r4(4i**4c4i4>*4r4[4i4i4i4t4i4r4i4i4i*****4i*4>*4i4  4i4t4t*>k*4t4(4i4t«**4c«4i4i4i 

•  Handle  event  from  parameter;  AAWThreatLevel 
*/ 

EVENT.HANDLER  AAWThreatLevel.Event  (value,  count) 

TEXT  *value(|;  /*  stnng  pomters  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  ♦/ 
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AA\VThret_Connect_PaneI  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

1 


I*  ^l^m^t^l^,*^t^t^f^t***^^**i^*r^*^^1,*>|L^l***}tt^l*^lt^t^,^t*********************************** 

*  Handle  event  from  parameter:  ASWEvent 
*/ 

EVENT_HANDLER  ASWEvent_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

f*  Begin  generated  code  for  Connection  */ 

ASW_Connect_PaneI  (NULL,  WPT_PREFERRED): 

/*  End  generated  code  for  Connection  */ 


♦  Handle  event  from  parameter:  ASWThreatLevel 
*/ 

EVENT_HANDLER  ASWThreatLevel_Event  (value,  count) 
TEXT  *value(];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  generated  code  for  Connection  */ 
ASWThreuConnecLPanel  (NULL,  WPT_PREFERRED); 
f*  End  generated  code  for  Connection  */ 


I*  ««*«***««**«***«*««** *«««*« **«>tnti4t****tfi4ii***«4i*«*4r ******** *«**t(r«4t*4i** 

*  Handle  event  from  parameter;  BGCourseSpeed 

*/ 

EVENT_HANDLER  BGCourseSpeed_Event  (value,  count) 

TEXT  *value(]:  /*  string  pointers  */ 

FUNINT  count;  f*  num  of  values  */ 

i 

/*  Begin  generated  code  for  Connection  */ 

BGCrsSpd_Connect_Panel  (NULL,  WPT_PREFERRLD); 

/*  End  generated  code  for  Connection  */ 

) 


^*  ************************************  ..*********************************** 

*  Handle  event  from  parameter;  Clo.se 
*1 

EVENT_HANDLER  Close_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

/*  Begin  generated  code  for  Connection  */ 

CloseAll_Connect_Panel  (NULL.  WPT_PRP.FF.RRED); 

/*  End  generated  code  for  Connection  */ 

} 


y*  ************************************************************************ 

*  Handle  event  from  parameter;  CommentLisi 
*/ 

EVENT_HANDLER  CommentList_Event  (value,  count) 


208 


TEXT  *value[]:  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 
ConimentL_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

1 


*  Handle  event  from  parameter:  Consol 
*/ 

EVENT_HANDLER  Consol_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  tor  Connection  */ 
Consol_Connect_Panel  (NULL,  WPT_PREFERRED); 
I*  End  generated  code  for  Connection  */ 


*  Handle  event  from  parameter:  EventList 
*/ 

EVENT_HANDLER  EventList_Event  (value,  count) 
TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/♦  Begin  generated  code  for  Connection  ♦/ 
EventLis_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

I 


****««« «««*****:«i***4<4i4>«***«*««****«*«*<I>**%*****4>***4>*4>«*'4>*************** 

*  Handle  event  from  parameter:  FuelTransfer 
*/ 

EVENT_HANDLER  FuelTransfer.  Event  (value,  count) 

TEXT  *value[]:  1*  string  pointers  •/ 

FUNINT  count;  /*  num  of  values  ♦/ 

I 

r*  Begin  generated  code  for  Connection  */ 

FuelTran_Connect_Panel  (NULL,  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

) 


•  Handle  event  from  parameter:  Help 

V 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

>  FUNINT  count;  /*  num  of  values  */ 

1 

/*  Begin  generated  code  for  Connection  */ 
Evend-is_Connect_Panel  (NULL.  WPT_PREFERRED); 
/•  End  generated  code  for  Connection  */ 

I  } 
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I*  4<«**4c**««4<*******4>***4<***4<*>l<*****«4<4<«***'l'4"t>*******4'4>*********'t<****4<«**4^* 

*  Handle  event  from  parameter;  OrdnanceTiansfe 
*1 

EVENT_HANDLER  OrdnanceTransfe_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  I*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 

OrdTrSeLConnect_Panel  (NULL.  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 

1 


I*  **%1f*:it7lt***m*****************ti*************i***m*’¥************^******if***if 

*  Handle  event  from  parameter;  Predict 
*/ 

EVENT_HANDLER  Predict_Event  (value,  count) 

TEXT  ♦value!];  /*  string  pointers  ♦/ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 

SelSumm_Connect_Panel  (NULL.  WPT_PREFERRED); 

/♦  End  generated  code  for  Connection  */ 

} 


1^  4<4<**4<>t<*******4i*****4i4>4<4i**'«i**4i**4<4i********«4i4i**><t>ti*4i*****4<**4i***4>%******** 

*  Handle  event  from  parameter;  Raid 
*/ 

EVENT_HANDLER  Raid_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  ♦/ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  generated  code  for  Connection  */ 

Raid_Connect_Panel  (NULL.  WPT.PREFERRED); 

/*  End  generated  code  for  Connection  */ 

I 


******4^*****«**4,«*****;)<*«4i4ii|i4c*4>**4>**4i**>)>«'4<**4>**4>**«*4>«*******«**4>******* 

*  Handle  event  from  parameter;  SetStation 

V 

EVENT_H ANDLER  SetStation_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  ♦/ 

{ 

/*  Begin  generated  code  for  Connection  */ 

SetStati_Connect_Panel  (NULL,  WPT_PREFERRED); 

/*  End  generated  code  for  Connection  */ 


*  Handle  event  from  parameter;  ShipCourseSpeed  * 

V 

EVENT_HANDLER  ShipCourseSpeed_Event  (value,  count) 

TEXT  ♦valued;  /•  string  pointers  */ 

FUNINT  count;  /♦  num  of  values  ♦/ 

{ 

/♦  Begin  generated  code  for  Connection  •/ 

ShCrsSpd_Connect_Panel  (NULL.  WPT_PREFERRED); 
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/*  End  generated  code  for  Connection  */ 

I 


*  Handle  event  from  parameter:  ShipList 
*1 

EVENT_HANDLER  ShipList_Event  (value,  count) 

TEXT  *value[];  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

f*  Begin  generated  code  for  Connection  */ 
BGShips_Connect_Panel  (NULL.  WPT_PREFERRED); 
f*  End  generated  code  for  Connection  */ 

1 


*  Handle  event  from  parameter:  Strike 
*/ 

EVENT_HANDLER  Strike_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  generated  code  for  Connection  */ 
Strike_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

1 


*  Handle  event  from  parameter;  Unrep 
*/ 

EVENT_HANDLER  Unrep_Event  (value,  count) 

TEXT  •value[l:  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  generated  code  for  Connection  */ 
Unrep_Connect_Panel  (NULL,  WPT_PREFERRED); 
/*  End  generated  code  for  Connection  */ 

} 


struct  DISPATCH  BGEventsDispatchQ  =  ( 

{ “ AAWThreatLevel”,  AAWThreatLevel_Event  | , 
{“ASWEvent”,  ASWEvent_Event}, 

( “AS WThreatLevel”,  ASWThreatLevel_Event ) , 

{ “BGCourseSpeed”,  BGCourseSpeed_E vent  | , 
{“Close”,  Close_Event|, 
j  “CommentList”,  CommentList_Event  | , 

{ “Consol”,  ConsoLEvent ) , 

{“EventList”,  EventList_Event  t , 

{ “FuelTransfer”.  FuelTransfer_Event  | , 

{“Help”,  Help_Event}, 

{ “OrdnanceTransfe”,  C)rdnanceTransfe_Event  | . 
(“Predict”,  Predict_Event  1 . 

{“Raid”,  Raid_Event|, 

{ “SetStation”,  SetStation_Event). 

{ “ShipCourseSpeed”,  ShipCourseSpeed_Event } , 
{“ShipList”.  ShipList_Event|, 
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{“Strike”,  Strike_Event  1 , 
i  “Unrep”,  Unrep_Event ) , 
(NULL,  NULL) 

1: 


/*  terminator  entry  */ 


212 


/*  *’*'*  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_BGEvents.h  ***  */ 

/*  Generated:  Jan  19  09:08:04  1993  ***  */ 

*  PURPOSE: 

*  Header  file  for  panel:  BGEvents 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  BGEvents 

* 

*  CHANGE  LOG: 

*  19'Jan-93  Initially  generated...TAE 

*  ************************************************************************** 
*/ 

#ifndef  I_PAN_BGEvents  /*  prevent  double  include  */ 

#define  l_PAN_BGEvents  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  BGEventsTarget.  BGEvents  View,  BGEventsId: 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  BGEventsDispatch[]; 

/*  Initialize  BGEventsTarget  and  BGEventsView  */ 
extern  VOID  BGEvents_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  ♦/ 
extern  VOID  BGEvents_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  BGEvents_Destroy_P3nel  (); 

/*  Connect  to  this  panel.  Create  it  or  change  it’s  state  */ 
extern  VOID  BGEvents_Connect_Panel  (); 

#endif 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  Overview.c  ***  */ 

/*  ***  Generated:  Jan  13  13:52:27  1993  ***  */ 

jir  «4<«**********««*>l«ii******«*««*****»4i4<***<t'>li*<t>*******>l«t<**4:>l'***«*>l<****4<«***4r 

*  PURPOSE: 

*  This  the  main  program  of  an  application  generated  by  the  TAE  Plus  Code 

*  Generator. 

* 

*  REGENERATED: 

*  This  file  is  generated  only  once. 

* 

*  NOTES: 

*  To  turn  this  into  a  real  application,  do  the  following: 

* 

*  1.  Each  panel  that  has  event  generating  parameters  is  encapsulated  by 

*  a  separate  file,  named  by  concatenating  the  string  “pan_”  with  the 

*  panel  name  (followed  by  a  “.c”).  Each  parameter  that  you  have  defined 

*  to  be  “event-generating”,  has  an  event  handler  procedure  in  the 

*  appropriate  panel  file.  Each  handler  has  a  name  that  is  a 

*  concatentation  of  the  parameter  name  and  the  string  “_Event”.  Add 

*  application-dependent  logic  to  each  event  handler.  (As  generated  by 

*  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of  the 

*  event.) 

* 

*  2.  To  build  the  program,  type  “make”.  If  the  symbols  TAEINC, ..., 

*  are  not  defined,  the  TAE  shed  (source)  scripts  $TAE/bin/csh/taesetup 

*  will  define  them. 

*  ADDITIONAL  NOTES: 

*  1 .  Each  event  handler  has  two  arguments:  (a)  the  value  vector 

*  associated  with  the  parameter  and  (b)  the  number  of  components.  Note 

*  that  for  scalar  values,  we  pass  the  value  as  if  it  were  a  vector  with 

*  count  1. 

* 

*  Though  it’s  unlikely  that  you  are  interested  in  the  value  of  a  button 

*  event  parameter,  the  values  are  always  passed  to  the  event  handler  for 

*  consistency. 

* 

*  2.  You  gain  access  to  non-event  parameters  by  calling  the  Vm  package 

*  using  the  targetid  Vm  objects  that  are  created  in 

*  lnitialize_All_Panels.  There  are  macros  defined  in  global.h  to  assist 

*  in  accessing  values  in  Vm  objects. 

* 

*  To  access  panel  Id.  target,  and  view,  of  other  panels,  add  an 

*  “#include”  statement  for  each  appropriate  panel  header  file. 

*  CHANGE  LOG; 

*  13-Jan-93  Initially  generated.. .TAE 
*1 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  "symtab.inc” 

#include  “global.h”  /*  Application  globals  */ 

Display  *Default_Display; 

BOOL  Application_Done  =  FALSE; 

main  (argc,  argv) 
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FUNINT  argc; 
TEXT  *argv[]; 


i 

WptEvent  wptEvent;  /*  event  data  */ 

CODE  eventType; 

COUNT  termLines,  termCols; 

CODE  termType,  ret;/*BERN*/ 

/*  PROGRAMMER  NOTE: 

*  add  similar  extern’s  for  each  resource  file  in  this  application 

V 

extern  VOID  Overview_Initialize_All_Panels  (): 
extern  VOID  Overview_Create_Initial_Panels  (); 

struct  DISPATCH  ’"dp;  /*  working  dispatch  pointer  */ 

IMPORT  struct  VARIABLE  ’"Vm_Find(); 

struct  VARIABLE  "parmv;  /*  pointer  to  event  VARIABLE  ■"/ 

/*  initialize  terminal  without  clearing  screen  */ 
t_pinit  (&termLines,  &termCols,  &termType); 

/*  permit  upper/lowercase  file  names  */ 
f_forceJower  ffALSE); 

Default_Display  =  Wpt_Init  (NULL); 

/*  initialize  resource  file  */ 
f*  PROGRAMMER  NOTE; 

*  For  each  resource  file  in  this  application,  calls  to  the  appropriate 
■"  Initialize_All_Panels  and  Create_Initial_Panels  must  be  added. 

V 

Overview_Initialize_All_Panels  (“Overview.res”); 
Overview_Create_Initial_Panels  (); 

f*  main  event  loop  */ 

/*  PROGRAMMER  NOTE: 

■"  use  SET_APPLICATION_DONE  in  “quit”  event  handler  to  exit  loop. 
■"  (SET_APPLICATION_DONE  is  defined  in  global.h) 

V 


ret  =  Wpt_SetHelpStyle(“wpthelp.res”); 
while  (!Application_Done) 

eventType  =  Wpt_NextEvent  (&wptEvent);  /*  get  next  WPT  event  */ 

switch  (eventType) 

I 

case  WPT_PARM_EVENT: 

/*  Event  has  occurred  from  a  Panel  Parm.  Lookup  the  event 
in  the  dispatch  table  and  call  the  associated  event 
*  handler  function. 

*1 

dp  =  (struct  DISPATCH  *)  wptEvent.p_useiContext; 
for  (;  (’"dp).paimName  !=  NULL;  dp-H-) 
if  (s_equal  ((’"dp).parmName,  wptEvent.parmName)) 

parmv  =  Vm_Find  (wptEvent.p_dataVm,  wptEvent.parmName); 
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(*(*dp).eventFunction) 

((*pannv).v_cvp,  (*parmv).v_count); 
bre^; 

) 

break; 

case  WPT_FILE_EVENT: 

/*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  file  events. 

*  Use  Wpt_AddEvent  and  Wpt_RetnoveEvent  to  register  and  remove 

*  event  sources. 

♦/ 

printf  (“No  EVENT_HANDLER  for  event  from  external  source.Nn”); 
break; 

case  WPT_WINr)OW_EVENT: 

I*  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  window  events. 

*  WPT_WiNDOW_EVENT  can  be  caused  by  windows  which  you  directly 

*  create  with  X  (not  TAE  panels),  or  by  user  acknowledgement 

*  of  a  Wpt_PanelMessage  (therefore  no  default  print  statement 

*  is  generated  here). 

*/ 

break; 

case  WPT_TIMEOUT_EVENT; 

/♦  PROGRAMMER  NOTE: 

*  Add  code  here  to  handle  timeout  events. 

*  Use  Wpt  SetTimeOut  to  register  timeout  events. 

*! 

printf  (“No  EVENT_HANDLER  for  timeout  event.Nn”); 
break; 

default: 


printf(“Unknown  WPT  EventNn”); 
break: 

I 

1  /*  end  main  event  loop  */ 

Wpt_FinishO;/*  close  down  all  display  connections  */ 
f*  PROGRAMMER  NOTE: 

*  Application  has  ended  normally.  Add  application  .specific  code  to 
’*  close  down  your  application 
V 


) 


/*  end  main  */ 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  Overview_creat_init.c  ***  */ 

I*  ***  Generated:  Jan  13  13:52:27  1993  ***  */ 

***4t****4<***%i|i*«******«****«*«4>«*i|i4i**«**4c*****4i^4i*4t««i|c****i|i4ii|t****«***4<** 

*  PURPOSE: 

*  Displays  all  panels  in  the  initial  panel  set  of  this  resource  file 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

A  panel  is  added  to  the  initial  panel  set 

*  A  panel  is  deleted  from  the  initial  panel  set 

*  For  the  set  of  initial  panels: 

*  Overview 

* 

*  CHANGE  LOG: 

*  13-Jan-93  Initially  generated...TAE 
*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “global.h”  /*  Application  globals  */ 

/*  One  include  for  each  panel  in  initial  panel  set  */ 

#include  “pan_Overview.h” 


FUNCTION  VOID  Overview_Create_lnitial_Panels  () 

I 

/*  Show  panels  */ 

Overview_Create  Panel  (NULL.  WPT_PREFERRED); 

I 
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/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  Overview_init_pan.c  */ 

/*  ***  Generated:  Jan  13  13:52:27  1993  ***  V 

I*  it^L^im******************************************************************** 

*  PURPOSE: 

*  Initialize  all  panels  in  the  resource  file. 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  A  panel  is  deleted 

*  A  new  panel  is  added 

*  A  panel’s  name  is  changed  (not  title) 

*  For  the  panels: 

*  Overview 

4c 

*  CHANGE  LOG: 

*  13-Jan-93  Initially  generated.. .TAE 

*  ^^:t,^,*^:ti:^:t‘*»i*****%**<ttm******************^i******************************** 

*/ 

#include  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “symtab.inc” 

#include  “global.h”  /*  Application  globals  */ 

/*  One  “include”  for  each  panel  in  resource  file  */ 

#include  “pan_Overview.h” 


FUNCTION  VOID  Overview_Initialize_All_Panels  (resfileSpec) 
TEXT  *resfileSpec; 

{ 

extern  Id  Co_Find  0: 
extern  Id  Co_New  (); 

Id  vmCollection ; 

/*  read  resource  file  */ 
vmCollection  =  Co_New  (P_ABORT); 

Co_ReadFile  (vmCollection.  resfileSpec,  P_ABORT); 

f*  initialize  view  and  target  Vm  objects  for  each  panel  */ 
Overview_Initialize_Panel  (vmCoUection); 

1 


218 


/*  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_Overview.c  ***  */ 

/*  **•  Generated:  Jan  14  08:16:26  1993  ***  ♦/ 

y*  t,:iL^i^i^^mm***m»L**’ii*’t>*m*******m************m*****m>i>***********************i* 

*  PURPOSE: 

*  This  file  encapsulates  the  TAE  Plus  panel:  Overview 

*  These  routines  enable  panel  initialization,  creation,  and  destruction. 

*  Access  to  these  routines  from  other  files  is  enabled  by  inserting 

*  ‘#include  “pan_Overview.h'”.  For  more  advanced  manipulation  of  the  panel 

*  using  the  TAE  routines,  the  panel’s  Id,  Target,  and  View  are  provided. 

* 

*  NOTES; 

*  For  each  parameter  that  you  have  defmed  to  be  “event-generating”  in 

*  this  panel,  there  is  an  event  handler  procedure  below.  Each  handier 

*  has  a  name  that  is  a  concatenation  of  the  parameter  name  and  “_Event". 

*  Add  application-dependent  logic  to  each  event  handler.  (As  generated 

*  by  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of  the 

*  event.) 

*  You  may  want  to  flag  any  changes  you  make  to  this  file  so  that  if  you 

*  regenerate  this  file,  you  can  more  easily  cut  and  paste  your 

*  modifications  back  in.  For  example: 

* 

*  generated  code ... 

*  f*  (+)  ADDED  yourinitials  *  / 

*  your  code 

*  /*(-)  ADDED*/ 

*  more  generated  code ... 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  Overview 

*  The  following  WorkBench  operations  will  also  cause  regeneration: 

*  An  item  is  deleted 

*  A  new  item  is  added  to  this  panel 

*  An  item's  name  is  changed  (not  title) 

*  An  item '  s  data  type  is  changed 

*  An  item’s  generates  events  flag  is  changed 

*  An  item's  valids  changed  (if  item  is  type  struig  and  connected) 

*  An  item's  connection  information  is  changed 

*  For  the  panel  items: 

*  Backup,  Close,  Events,  Forward, 

*  Help,  Index,  SetUp 

* 

*  CHANGE  LOG: 

*  14-Jan-93  Initially  generated...TAE 
*/ 

tinclude  “taeconf.inp” 

#include  “wptinc.inp” 

#include  “glotel.h”  /*  Application  globals  */ 

#include  “pan_Overview.h’’ 

/*  One  “include”  for  each  connected  panel  */ 

Id  OverviewTarget,  OverviewView,  Overviewld; 
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/*  OverviewDispatch  is  defined  at  the  end  of  this  file  */ 

^  ^^,*>timm*****mo‘********m**m*****-f***************************************** 

*  Initialize  the  view  and  target  of  this  panel. 

*/ 

FUNCTION  VOID  Overview_InitiaIize_Panel  (vmCollection) 

Id  vmCollection; 
i 

Id  Co_Find  O'. 

OverviewView  =  Co_Find  (vmCollection,  ‘■Overview_v”); 

OverviewTarget  =  Co_Find  (vmCollection,  “Overview_f’); 

I 


*  Create  the  panel  object  and  display  it  on  the  screen. 

V 

FUNCTION  VOID  Overview_Create_Panel  (relativeWindow.  flags) 
Window  relativeWindow; 

COUNT  flags; 


if  (Overviewld) 

printf  (“Panel  (Overview)  is  already  displayed.Sn”); 
else 

Overviewld  =  Wpt_NewPanel  (Default_Display,  OverviewTarget,  OverviewView, 
relativeWindow,  OverviewDispatch,  flags); 


*«*itc*«4>*4>****«********4i*4<«**««**«****«******«**«******:«i********«*:l>****** 

*  Erases  a  panel  from  the  screen  and  de-allocate  the  associated  panel 

*  object, 

*1 

FUNCTION  VOID  Overview_Destroy_Panel  0 
{ 

Wpt_PanelErase(OverviewId); 

Overviewld=0; 

I 


*  Connect  to  this  panel.  Create  it  or  change  it’s  state. 

*/ 

FUNCTION  VOID  Overview_Connect_Panel  (relativeWindow,  flags) 
Window  relativeWindow; 

COUNT  flags; 

{ 

if  (Overviewld) 

Wpt_SetPanelState  (Overviewld,  flags); 
else 

Overview_Create_Panel  (relativeWindow,  flags); 

1 


I*  ***************************************************************^*****^^t^ 

*  Handle  event  from  parameter:  BackUp 
*/ 

EVENT_HANDLER  BackUp_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 
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/*  Begin  default  generated  code  */ 


printf  (“Panel  Overview,  parm  BackUp:  value  =  %s\n”, 
counoO  ?  value[0]  :  “none”); 

/*  End  default  generated  code  */ 

1 


*  Handle  event  from  parameter:  Close 
*/ 

EVENT_HANDLER  Close_Event  (value,  count) 
TAEINT  value[];  /*  integer  vector  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  Close:  value  =  %d\n”, 
count>0  ?  value[0] ;  0): 

/*  End  default  generated  code  */ 

/*  Begin  generated  code  for  Connection  */ 

Overview_Destroy_Panel  0: 
SET_APPLICATION_DONE: 

/*  End  generated  code  for  Connection  ♦/ 

} 


y*  *««**iti****4i**«***«<l>4>*«*4i**4<*****4i**4i4i4i*4i4i***«*4i4i>|i4i************>ti«4>* ****** 

*  Handle  event  from  parameter:  Events 
*/ 

EVENT_HANDLER  Events_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

{ 

/*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  Events;  value  =  %s\n", 
count>0  ?  value[01 ;  “none”); 

/*  End  default  generated  code  */ 

I 


y*  **********************«************4,««4l;^«*4,4,*«**;),^**«*4,«;^4,4,;|,«4,«;„;^,^^^^4,^^ 

*  Handle  event  from  parameter;  Forward 
*/ 

EVENT_HANDLER  Forward_Event  (value,  count) 

TEXT  *value[];  f*  string  pointers  */ 

FUNINT  count:  /*  num  of  values  */ 

I 

f*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  Forward;  value  =  %.s\n”, 
count>0  ?  value(0] :  “none”): 
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/*  End  default  generated  code  */ 


y*  ^trHi^^,m***'t>************************************************************** 

*  Handle  event  from  parameter;  Help 
*1 

EVENT_HANDLER  Help_Event  (value,  count) 

TEXT  ♦value[];  f*  siring  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  Help;  value  =  %s\n’’. 
couni>0  ?  value[01 ;  “none”): 

/*  End  default  generated  code  */ 

I 


I*  **4,^4i4i*4i«*:ti«:ti«*4t4i***«***4i«<l>***4>**il'**4'****<<>*4>4<***4t****4>«**4i*4i  ******  ****** 

*  Handle  event  from  parameter;  Index 
*/ 

EVENT_HANDLER  Index_Event  (value,  count) 

TEXT  •value[]:  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

( 

/*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  Index;  value  =  %sNn”. 
counoO  ?  value[0] ;  “none”); 

/*  End  default  generated  code  */ 


*  Handle  event  from  parameter;  SetUp 

V 

EVENT_HANDLER  SetUp_Event  (value,  count) 
TEXT  ‘valued;  /*  string  pointers  */ 

FUNINT  count;  /*  num  of  values  */ 

I 

f*  Begin  default  generated  code  */ 

printf  (“Panel  Overview,  parm  SetUp:  value  =  %s\n”, 
count>() '!  value[01 :  “none”); 

f*  End  default  generated  code  */ 

I 


struct  DISPATCH  OverviewDispatchd  =  ( 
r‘BackUp",  BackUp_Event}, 

I  “Close",  Close_Event  | , 

(“Events",  Events_Event|, 

(“Forward”,  Forward_Event } . 

(“Help”,  Help_Event}, 

(“Index”,  Index_Event) , 

(“SetUp".  SetUp_Event  1 , 
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t*  **♦  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  ***  */ 

/*  ***  File:  pan_Overview.h  ***  */ 

/*  *♦*  Generated:  Jan  13  13:52:27  1993  */ 

■f*********************************************************************** 

*  PURPOSE: 

*  Header  file  for  panel:  Overview 

* 

*  REGENERATED: 

*  The  following  WorkBench  operations  will  cause  regeneration  of  this  file: 

*  The  panel’s  name  is  changed  (not  title) 

*  For  panel: 

*  Overview 

*  CHANGE  LOG: 

*  13-Jan-93  Initially  generated.. .TAE 

*  *****4<>t'*>k***4>*i|<***********4i«***%;|c*«*s|<«**4<******************««******«*«««** 

*1 

#ifndef  l_PAN_Overview  /*  prevent  double  include  */ 

#define  I_PAN_Overview  0 

/*  Vm  objects  and  panel  Id.  */ 

extern  Id  OverviewTarget,  Overview  View.  Overviewld; 

/*  Dispatch  table  (global  for  calls  to  Wpt_NewPanel)  */ 
extern  struct  DISPATCH  OverviewDispatch[]; 

/*  Initialize  OverviewTarget  and  OverviewView  */ 
extern  VOID  Overview_Initialize_Panel  (); 

/*  Create  this  panel  and  display  it  on  the  screen  */ 
extern  VOID  Overview_Create_Panel  (); 

/*  Destroy  this  panel  and  erase  it  from  the  screen  */ 
extern  VOID  Overview_Destroy_Panel  (); 

/*  Connect  to  this  pwel.  Create  it  or  change  it’s  state  */ 
extern  VOID  Overview_Connect_PaneI  (); 

#endif 
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APPENDIX  C.  BGLCSS  2.0  C++  PROGRAM  LISTING 


C++  files  generated  by  TAE  Plus  contained  is  this  appendix: 

BGSetup.cc 

BGSetup.h 

BGSetup_creat_init.cc 

BGSetup_init_pan.cc 

Imakefile 

item_SetUpBGs.h 

pan_SetUpBGs.cc 

pan_SetUpBGs.h 
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//  *’*  TAB  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  *'* 

//  ’**  File:  BGSetup.cc  **• 

//  •’*  Generated:  Mar  10  07:51:07  1993  *** 

//////r//////////////////////////////////////////////////////////////// 

//  PURPOSE: 

//  This  the  main  program  of  an  application  generated  by  the  TAE  Plus 
/ /  Code 
//  Generator. 

//  % 
//  REGENERATED: 

//  This  file  is  generated  only  once. 

// 

//  NOTES: 

//  To  turn  this  into  a  real  application,  do  the  following: 

// 

//  1.  Each  panel  that  has  event  generating  parameters  has  a  class 
//  definition  file,  named  by  concatenating  the  string  'pan_'  with  the 
//  panel  name  followed  by  a  '.h*.  The  methods  are  in  a  separate  file, 

//  named  by  concatenating  the  string  'pan_'  with  the  panel  name 
//  followed  by  a  '.cc'.  Each  item  has  a  class  definition  in  a  file 
//  named  by  concatenating  the  string  'icem_'  with  the  panel  name 
//  followed  by  a  '.h*.  Each  parameter  chat  you  have  defined  to  be 
//  'event-generating',  has  an  event  handler  method  in  the  appropriate 
//  panel  file.  Add  application-dependent  logic  to  each  event  handler. 

//  (As  generated  by  the  WorkBench,  each  event  handler  simply  logs  the 
//  occurrence  of  the  event.) 

// 

//  2.  To  build  Che  program,  type  'make'.  If  the  symbols  TAEINC,  ..., 

//  are  not  defined,  the  TAE  shell  (source)  scripts  $TAE/bin/csh/// 

//  taesetup 

//  will  define  them. 

// 

//  ADDITIONAL  NOTES: 

//  1.  Each  event  handler  has  one  argument:  the  actual  wpcevenc 
// 

//  2.  You  gain  access  to  non-event  parameters  by  calling  the  TaeVar 
//  and  TaeVarTable  methods  using  the  instances  of  TaeVar  and 
//  TaeVarTable  associated  with  the  panel. 

// 

//  To  access  ocher  panels,  add  an  'ttinclude'  statement  for  each 
//  appropriate  panel  header  file. 

// 

//  CHANGE  LOG: 

//  lO-Mar-93  Initially  generated. . .TAE 

/////////////////////////////////////////////////////////////////////// 

#include  <scream.h> 
ttinclude  <taepanel.h> 

#include  <caeitem.h> 
ttinclude  <caevm.h> 

// 

//  PROGRAMMER  NOTE: 

//  For  each  resource  file  in  this  application,  add  the  appropriate 
//  header  file 

// 

ttinclude  'BGSeCap.h' 

Display  '  defaulcDisplay; 

TaeEventHandler  'eventHandler ; 

main( ) 

{ 

COUNT  Clines,  ccols; 

CODE  Ctype; 
f_force_lower  (FALSE); 
t_pinit  (&tlines,  stcols,  &ttype)  ,- 

defaulcDisplay  =  Wpt_CCInit  (  NULL 

// 

//  PROGRAMMER  NOTE: 

//  For  each  resource  file  in  this 
/ /  appropriate  constructors 

// 

BGSetupResource  'BGSetupR  =  new  BGSecupResource ( ) ; 


//  permit  upper/ lowercase  file  names 
//  initialize  terminal  pkg 


application,  add  calls  to  the 
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evencHandler  =  new  TaeEventHandler { ) ; 

// 

//  PROGRAMMER  NOTE: 

//  For  each  resource  file  in  this  application,  calls  to  the 
//  appropriate  Initialize_All_Panels  and  Create_Initial_Panels 
//  method  must  be  added. 

// 

//  Initialize  all  panel  instances 
BGSetupR->Initialize_All_Panels ( ) : 

//  Create  and  display  the  initial  panel  set 
BGSetupR->Create_Initial_Panels {  ‘eventHandler  ); 
eventHandler->ProcessEvents ( ) ;  //  Start  event  processing 

Wpt_Finish() ;  //  Close  all  display  connections 


//  **’  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EOT  1992  **’ 

//  ***  File:  BGSecup.h  *** 

//  ***  Generated:  Mar  10  07:51:07  1993 

/////////////////////////////////////////////////////////////////////// 

//  PURPOSE: 

//  This  header  file  encapsulates  the  TaeResource  that  corresponds  with 
//  the  resource  file  /h/bglcss/scripts/gui/secup/c+-/BGSetup . res . res . 

// 

//  REGENERATED:  % 

//  This  file  is  generated  only  once. 

// 

//  CHANGE  LOG: 

//  lO-Mar-93  Initially  generated ... TAE 
/////////////////////////////////////////////////////////////////////// 

#ifndef  I_SIMPLE  //  prevent  double  include  ■* 

#define  I_SIMPLE0 

(t include  <taepanel.h> 

# include  <taeitem.h> 

# include  <taevm.h> 

// 

//  BGSetupResource  contains  methods  that  have  implication  on  the 
//  resource  file  BGSetup.res. 

// 

class  BGSetupResource  :  public  TaeResource 

{ 

public: 

BGSetupResource  ()  :  ( '/h/bglcss/scripcs/gui/setup/c+  +  /BGSetup . res' 1  {); 

-BGSetupResource  ( )  { ) : 

void  Initialize_All_Paneis  (); 

void  Create_Inicial_Panels  (  const  TaeEventHandiers  ) ; 

); 

tfendif 
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//  *’*  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EOT  1992 
//  ***  File:  BGSetup_creat_init.cc  *** 

//  **»  Generated:  Mar  10  07:51:07  1993 

/////////////////////////////////////////////////////////////////////// 
//  PUR POSE : 

//  Displays  all  panels  in  the  initial  panel  sec  of  this  resource  file 

// 

//  REc;ENERATED  : 

//  Tne  followj.na  WorkBench  operat.cr  ;  will  luse  rcgeneraticr.  cf  thlt 
//  file: 

//  A  panel  is  added  to  Che  initial  panel  set 

//  A  panel  is  deleted  from  the  initial  panel  set 

//  For  Che  sec  of  initial  panels: 

//  SetUpBGs 

// 

//  CHANGE  LOG: 

//  lO-Mar-93  Initially  generated. . .TAE 

/////////////////////////////////////////////////////////////////////// 

# include  <stream.h> 
tt include  <caepanel.h> 
ttinclude  <caeicem.h> 

((include  <caevm.h> 

♦include  'BGSetup.h' 

//  One  'include”  for  each  panel  in  the  initial  panel  sec 
♦include  "pan_SecupBGs .h' 


void  BGSetupResource: :Create_Initial_Panels  (const  TaeEventHandler&  eh) 
{ 

SetUpBGsP->Show ( eh) ; 

) 
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//  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EOT  1992  *** 
//  ***  File:  BGSetup_init_pan.cc  *** 

//  ***  Generated:  Mar  10  07:51:07  1993 

/////////////////////////////////////////////////////////////////////// 
//  PURPOSE: 

//  Initialize  all  panels  in  the  resource  file. 

// 

//  REGENERATED: 

//  The  following  WorkBench  operations  will  cause  regeneration  of  this 
//  file: 

//  A  panel  is  deleted 

//  A  new  panel  is  added 

//  A  panel's  name  is  changed  (not  title) 

//  For  the  panels: 


// 

Acf tLoad, 

AirData, 

BGData,  BGShips, 

CloseAll , 

DelBG, 

// 

Deletesh, 

Delship, 

Dtg,  F44Fuel, 

F76Fuel, 

LackData, 

// 

NewBG , 

OrdData, 

// 

// 

OrdLoad, 

OrdSel, 

Print Job,  SaveNewB, 

SelBG, 

SetUpBGs,  Ship, 

//  CHANGE  LOG: 

//  lO-Mar-93  Initially  generated. . .TAE 
/////////////////////////////////////////////////////////////////////// 
ttinclude  <stream.h> 

♦include  <Caepanel.h> 
ttinclude  <caeicem.h> 

♦include  <caevm.h> 

♦include  'BGSetup.h' 

//  One  "include"  for  each  panel  in  resource  file 
♦include  "pan_Acf tLoad.h' 

♦include  "pan_AirDaca.h" 

♦include  "pan_BGData .h" 

♦include  "pan_BGShips .h' 

♦include  "pan_CloseAll .h' 

♦include  "pan_DelBG .h" 

♦include  'pan_DeleteSh.h" 

♦include  "pan_DelShip.h" 

♦include  'pan_Dtg.h' 

♦include  'pan_F44Fuel.h' 

♦include  "pan_F76Fuel .h" 

♦include  "pan_LackDaCa.h' 

♦include  'pan_NewBG.h' 

♦include  'pan_OrdData.h" 

♦include  'pan_OrdLoad.h" 

♦include  'pan_OrdSel .h' 

♦include  "pan_PrintJob.h' 

♦include  "pan_SaveNewB.h" 

♦include  "pan_SelBG.h' 

♦include  "pan_SetUpBGs .h" 

♦include  "pan_Ship.h" 

void  BGSetupResource: : Initialize_Ali_Panels  () 

{ 

//  Create  an  instance  of  all  panels 
AcftLoadP  =  new  AcftLoadC  (Collection  ())  ,- 
AirOataP  =  new  AirDataC  (Collection ()) ; 

BGDataP  =  new  BGDataC  (Collection( ) ) ; 

BGShipsP  =  new  BGShipsC  (Collection( ) )  ,- 
CloseAllP  =  new  CloseAllC  (Colleccion( ) ) ; 

DelBGP  =  new  DelBGC  (Collection( ) ) ; 

DeleteShP  =  new  DeleteShC  (Collection( ) ) ; 

DelShipP  =  new  DelShipC  (Collection ()) ; 

DtgP  =  new  DtgC  (Collection( ) ) ; 

F44FuelP  =  new  F44FuelC  (Collection ()) ; 

F76FuelP  =  new  F76FuelC  (Collection( ) ) ; 

LackDataP  =  new  LackDataC  (Collection ())  ,- 
NewBGP  =  new  NewBGC  (Collection( ) ) ; 

OrdDataP  =  new  OrdDataC  (Collection [)) ; 

OrdLoadP  =  new  OrdLoadC  (Collection ()) ; 

OrdSelP  =  new  OrdSelC  (Collection( ) ) ; 

PrintJobP  =  new  PrintJobC  (Collection( ) ) ; 

SaveNewBP  =  new  SaveNewBC  (Collection ( j ) ; 

SelBGP  =  new  SelBGC  (Collection) )) ; 

SetUpBGsP  =  new  SetUpBGsC  (Collection) ))  ,- 
ShipP  =  new  shipC  (Collection))); 

) 
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/♦  tae  Plus  Code  Generator  version  Tue  May  26  14:13:27  EOT  1992  *♦'  * 
/♦  .»»  File:  Iraakefile  ***  */ 

/*  **•  Generated:  Mar  10  07:51:07  1993  */ 

*  PURPOSE; 

*  This  is  the  Imakefile  of  a  C++  application  generated  by  the  TAE  Plus 

*  Code  Generator. 

* 

*  REGENERATED: 

'  This  file  IS  geneiatea  only  once. 

* 

*  NOTES: 

*  1.  To  build  your  application,  type  'make*.  The  Makefile  generated 

*  by  the  TAE  code  generator  invokes  imake  using  this  Imakefile  to 

*  generate  an  application  specific  Makefile. 

* 

*  2.  If  you  change  the  name  of  your  resource  file  or  application,  you 

*  will  need  to  either  edit  this  file,  or  just  delete  it  and  regenerate 

*  the  code. 

* 

*  3.  Edit  this  file  to  include  your  application  specific  source 

*  files. 

*  ***«**«***  +  .^«*************««ir  +  *  +  *«««*««**««**x**««**«««*«**«wr4««**«  +  * 
*/ 

idefine  GeneratedApplication 
/*  PROGRAMMER  NOTE: 

*  Add  a  line  'ttinclude  ' Imake. RESFILENAME"  for  each  resource  file  in 

*  your  application. 

V 

# include  ' Imake. BGSetup' 


/*  PROGRAMMER  NOTE: 

*  Insert  application  specific  build  parameters.  These  override 
’  definitions  in  the  configuration  files  in  $TAE/config. 

*/ 

C++DEBUGFLAGS  = 

LD++DESUGFLAGS  = 

APP_C++ FLAGS  = 

APP_LOAD_FLAGS  = 

AP?_LINKLIBS  =-L/h/bglcss/CC2.1/SC1.0/libC.a 
APP_DEPLIBS  =  S(DEPLIBS) 

APP_C++ INCLUDES  =  -I$(TAEINC)\ 

-I$(TAE1NCXM)\ 

-l/h/bglcss/CC2 . 1/SCl .0/include/CC 

PROGRAM  =  BGSetup 
/’  PROGRAMMER  NOTE: 

*  Add  S (SRCS^RESFILENAME)  and  $ (OBJS_RESFILENAME)  for  each  resource  file 

*  in  your  application. 

V 

GENSRCS  =  $ (PROGRAM) .CC  $ (SRCS_BGSetup) 

GENCBJS  =  $ (PROGRAM) .o  $ (OBJS_BGSetup) 

/*  PROGRATfl-lEP.  NOTE: 

*  Add  your  application  specific  srcs  and  object  files  (that  are  not 

*  generated  by  Che  code  generator)  here. 

•/ 

APPSRCS  = 

APP03JS  = 

/*  Macro  (defined  in  TAEmake . tmpl )  to  generate  Makefile  targets. 

♦/ 

CPlusPlusApplication ( $ ( PROGRAM) ) 
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//  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EOT  1992  *’• 
//  ***  File:  item_SetUpBGs.h  *** 

//  Generated:  Mar  10  07:51:07  1993 

/////////////////////////////////////////////////////////////////////// 
//  PURPOSE: 

//  This  file  contains  class  definitions  and  instance  declarations  of 
//  all  items  in  the  TAE  Plus  panel: 

//  SetUpBGs 

// 


'/  The  following  WorkBench  operations  will  cause  regeneration  of  this 


// 

// 

// 

// 

// 

//  The  following  WorkBench  operations  will  also  cause  regeneration: 

// 

// 

// 

// 

// 

//  Close,  Delete,  Edit,  Help, 

// 

1 1 

//  CHA14GE  LOG: 

//  lO-Mar-93  Initially  generated. . .TAE 
/////////////////////////////////////////////////////////////////////// 


file: 

The  panel's  name  is  changed  (not  title) 
For  panel : 

SetUpBGs 


An  item  is  deleted 
A  new  item  is  added  to  this  panel 
An  item's  name  is  changed  (not  ti,.le) 

An  item's  generates  events  flag  is  changed 
For  the  panel  items: 

Close,  Delete,  Edit, 

New 


«ifndef  I_ITEM_SetUpBGs  //  prevent  double  include 

#define  I_ITEM_SecUpBG?  0 

((include  <taepanel.h> 

((include  <taeitem.h> 

#include  <taevm.h> 

// 

//  Class  definitions  for  the  items  on  this  panel 

// 

class  setUpBGs_CloseC  :  public  Taeltem 
{ 

void  React  (WptEvent*  event);  //  item's  event  handler 

public: 

SecUpBGs_CioseC  (TaePanel  *  a)  ;  (a,  "Close")  { } ; 

},- 


class  SetUpBGs_DeieceC  :  public  Taeltem 
( 

void  React  (WptEvent*  event);  //  item's  event  handler 

public : 

SetUpBGs_DeleceC  (TaePanel  *  a)  :  (a,  "Delete")  {); 

): 


Ift*********it**1t***1c1t*****lt*liir*it*1i*1i*1t*1ili*t***^*-*li***fki,lifk\*^**%ii*^^% 

class  SecUpBGs_EditC  ;  public  Taeltem 

{ 

void  React  (WptEvent*  event);  //  item.'s  event  handler 

public : 

SetUpBGs_EditC  (TaePanel  *  a)  :  (a,  "Edit")  (); 

); 


y'y'****#**^ll>»»»*4’********»***************«*«********«**«**«**«««**t****« 

class  SetUpBGs_HelpC  :  public  Taeltem 

{ 

void  React  (WptEvent*  event);  //  item's  event  handler 

public : 

SetUpBGs_HelpC  (TaePanel  *  a)  :  (a,  "Help")  {}; 

}; 

y^***««********«***«««*************««***********4*««********««*««*«*»* 

class  SeCUpBGs_NewC  :  public  Taeltem 

{ 

void  React  (WptEvent*  event);  //  item's  event  handler 

public : 
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SetUpBGs_NewC  (TaePanel  *  a)  :  (a,  'New')  {); 
}; 

// 

//  Item  instances 

// 

extern  SetUpBGs_CloseC  *SetUpBGs_CloseI; 
extern  SetUpBGs_DeleteC  *SetUpBGs_DeleteI; 
extern  SetUpBGs_EditC  »SetUpBGs_EditI ; 
extern  SetUpBGs_HelpC  *SetUpBGs_HelpI; 
extern  ?ecUpBGs_Newc  *SecUpBGs_iIewl  ; 

#endif 
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//  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1992  **’ 

//  ***  File:  pan_SetUpBGs.cc  *** 

//  ***  Generated:  Mar  10  07:51:07  1993  *♦* 

/////////////////////////////////////////////////////////////////////// 

//  PURPOSE: 

//  This  file  encapsulates  the  TAE  Plus  panel:  SetUpBGs 

//  SetUpBGsP  is  an  instance  of  the  class  SetUpBGsC  which  is  a  derived 

//  class  of  the  TaePanel  class.  Access  to  public  methods  and  the 

//  SetUpBGsP  instance  from  other  files  is  enabled  by  inserting  ^ 

//  '#include  'pan_SetUpBGs.h"  . 

/  / 

//  NOTES: 

//  For  each  parameter  that  you  have  defined  to  be  'event-generating" 

//  in  this  panel,  there  is  an  event  handler  method  defined  below. 

//  Each  handler  is  a  method  called  React  in  the  corresponding  item 

//  class.  /T- 

//  Add  application-dependent  logic  to  each  event  handler.  (As 
//  generated 

//  by  the  WorkBench,  each  event  handler  simply  logs  the  occurrence  of 
//  the 
/ /  event . ) 

// 

//  You  may  want  to  flag  any  changes  you  make  to  this  file  so  that  if 
//  you 

//  regenerate  this  file,  you  can  more  easily  cut  and  paste  your 
//  modifications  back  in.  For  example: 

// 

//  generated  code  . . . 

//  //  (+)  ADDED  yourinitials 

//  your  code 
n  //  (-)  ADDED 
//  more  generated  code  . . . 

// 

// 

// 

//  REGENERATED: 

//  The  following  WorkBench  operations  will  cause  regeneration  of  this 
//  file: 

//  The  panel's  name  is  changed  (not  title) 

//  For  panel: 

//  SetUpBGs 
// 

//  The  following  WorkBench  operations  will  also  cause  regeneration: 

//  An  item  is  deleted 

/,'  A  new  item  is  added  to  this  panel 

//  An  item's  name  is  changed  (not  title) 

//  An  item's  data  type  is  changed 

//  An  item's  generates  events  flag  is  changed 

//  An  item's  valids  changed  (if  item  is  type  string  and  c'^nnected) 

//  An  item's  connection  information  is  changed 
//  For  the  panel  items: 

//  Close,  Delete,  Edit,  Help, 

//  New 
// 

//  CH.ANGE  LOG; 

//  lO-Mar-93  Initially  generated. . .TAE 

//!  i I;.'  f  f i ////////////// f n //////////!// / 

^include  <stream,.h> 

♦  include  <taepa.tel  .h> 

♦include  <taeitem.h> 

♦  include  <tae'/m..h> 

♦include  *pan_SetjpBGs .h' 

♦include  " item_SetUpBGs .h' 

//  One  'include'  for  each  connected  panel 

♦include  "pan_CloseAll .h’  ( 

♦include  "pan^DelBG.h" 

♦include  'pan_BGData .h' 

♦include  'pan_NewBG .h' 

// 

//  Panel  Instance 
// 

SetUpBGsC  'SetUpBGsP; 


//  Panel  class  declaration 
//  Item  class  declarations 
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// 

//  Item  Instances 
// 

SeCUpBGs_CloseC  *SeCUpBGs_CloseI ; 
SecUpBGs_DeleceC  *SetUpBGs_DeleceI ; 
SeCUpBGs_EdiCC  ’SetUpBGs_EditI ; 
SeCUpBGs_HelpC  ‘SetUpBCsJelpI  ; 
SecUpBGs_NewC  *SeCUpBGs_NewI ; 


// 

//  Panel  class  constructor 

// 

SetUpBGsC: :SetUpBGsC  (TaeCollection  ‘collect)  :  CSetUpBGs',  collect) 
{ 

// 

//  create  an  instance  of  each  item  in  the  panel. 

// 

SetUpBGs_CloseI  =  new  SetUpBGs_CloseC  (this); 

SetUpBGs_DeleteI  =  new  setUpBGs_DeieteC  (this); 

SecupBGs_EditI  =  new  setUpBGs_Edicc  (this); 

SetUpBGs_HelpI  =  new  SetUpBGs_HelpC  (this) ; 

SetUpBGs_NewI  =  new  Set[JpBGs_NewC  (this); 

} 


// 

//  Panel  class  destructor 
// 

SetUpBGsC : : ~SetUpBGsC  ( ) 

{ 

delete  SetUpBGs_CloseI ; 
delete  SetUpBGs_DeleteI ; 
delete  SetUpBGs_EditI ; 
delete  SetUpBGs_HelpI ; 
delete  SetUpBGs_NewI ; 

) 


//////////////////////////////////////////zV/////////////////////////////// 

//  Handle  event  from  parameter:  Close 

// 

void  SetUpBGs_cioseC: : React  (WpcEvent  ‘event) 

{ 

//  get  the  target  variable  from  Che  event 

TaeVar  ‘iCemVariable  =  GeCTargecVar (  (WpcEvent  ‘jevenc  ); 

couc  «  'Panel  '  «  Parent () ->Name( ) 

«  parm  '  «  itemVariable->Name ( ) 

«  ' :  value  =  ' 

«  (  icemVariable->Counc ( ) >0  ?  itemVariable->String ( )  :  'none”  ) 

«  '\n'; 
cout . f lush ( ) ; 

//  Begin  generated  code  for  Connection 

CloseAllP->Show( ‘Parent ( ) ->Handler ( ) ) ; 

//  End  generated  code  for  Connection 
) 


/////////////////////'///////////////////////////////////////////////////// 

//  Handle  event  from  parameter:  Delete 

// 

void  SecUpBGs_DeleteC: : React  (WptEvent  ‘event) 

{ 

//  get  the  target  variable  from  the  event 

TaeVar  ‘itemVarlable  =  GetTargetVar (  (WptEvent  ‘) event  ); 

cout  «  'Panel  '  «  Parent () ->Name( ) 

«  ',  parm  '  «  itemVarlable->Name( ) 

«  ' :  value  s  ' 

«  (  itemVariable->Count(  )>0  7  itemVariable->string( :  'none'  ) 

«  '\n'; 
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cout . f lush  (  )  ; 

//  Begin  generated  code  for  Connection 
DelBGP->Show  t  'Parent  { )  ->Handler  ( ) ; 

//  End  generated  code  for  Connection 


///////////////////////////////////////////////////////////////////////// 
//  Handle  event  from  parameter:  Edit 
// 

void  Sec'JpBGs_EditC :  :React  (WptEvent  'event) 

{ 

//  get  the  target  variable  from  the  event 

TaeVar  'itemVariable  =  GetTargetVar ;  (WptEvent  ' i event  ); 

cout  <<  'Panel  "  «  Parent () ->Name ! ) 

«  ",  parm  "  «  itemVariable->Name ( ) 

<<  " :  value  =  ' 

«  (  iceiiiVariable->Count  ( )  >0  ?  itemVariable->String  (  )  :  "none"  ) 
«  '\n"; 
cout -  flush ( ) ; 

//  Begin  generated  code  for  Connection 

BGDacaP->Show i ‘ r  ar tnt { ) ->Handler ( ) ) ; 

/'  TCL:  quit  '/ 

//  End  generated  code  for  Connection 
) 


/  / ;  I ! ! ! !  /  /  / 1 !  ij  m  m  /  n  / !  i !  /  n !  n !  m  /  /  / ,' / : ,' !  u  / ! !  u  1 ! !  / !  I  /  n !  /  i )  /  / ! !  n ! 

1 1  Handle  event  from  parameter:  Help 
// 

void  SecUp3Gs_HeipC:  .-React  (WptEvent  'event; 

{ 

//  get  the  target  variable  from  the  event 

Tae'/ar  'itemVariable  =  GetTargetVar)  (WptEvent  ')  event  ); 


cout  «  'Panel  '  «  Parent () ->Name( ) 

<<  parm  "  «  itemVariable->Name ( ) 

«  ' :  value  =  ' 

«  (  itemVariable->Count ( ) >0  ?  itemVariable->String ( )  :  "none" 
«  '\n'; 
cout . flush) ) ; 

} 


////////////////////////////////////////////////////////////////,','/////// 
//  Handle  event  from  parameter:  New 

// 

void  SetUpBGs_NewC :: React  (WptEvent  'event) 

{ 

//  get  the  target  variable  from  the  event 

TaeVar  'itemVariable  =  GetTargetVar)  (WptEvent  '(event  i; 

cout  <<  "Panel  '  «  Parent () ->Name ; ) 

<<  ",  parm  '  «  itemVariable->Narae( ) 

«  ":  value  =  ' 

<<  (  itemVariable->Count  ( )  >0  ?  iCemVariable->String(  i  ;  "none" 

<<  "\n'; 
cout . flush ( )  ; 

//  Begin  generated  code  for  Connection 

NewBGP->Show ( 'Parent ( ) ->Handier ( ) )  ; 

/'  TCL:  quit  '/ 


//  End  generated  code  for  Connection 
) 


//  ***  TAE  Plus  Code  Generator  version  Tue  May  26  14:13:27  EDT  1932  ”* 
//  **•  File:  pan_SeCUpBGs.h  *** 

//  **•  Generated:  Mar  10  07:51:07  1993  **’ 

/////////////////////////////////////////////////////////////////////// 
//  PURPOSE: 

//  Header  file  for  panel:  SetUpBGs 

// 

// 

//  For  panel: 

/ /  SetUpBGs 
// 

//  CHANGE  LOG: 

//  lO-Mar-93  Initially  generated. . -TAE 
/////////////////////////////////////////////////////////////////////// 

ttifndef  I_PAN_SetUpBGs  //  prevent  double  include 

#define  I_PAN_Set'JpBGs  0 

♦include  <taepanel.h> 

♦include  <taeitem.h> 

♦  include  <taevin.h> 


// 

//  Class  definition  for  the  SetUpBGsC  class  which  is  a  derived  class 
//  of  TaePanel  class. 

// 

class  SetUpBGsC  ;  public  TaePanel 

{ 

public : 

SetUpBGsC  (TaeCollection  ’collect); 

-SetUpBGsC  { ) 


instance  of  SetUpBGsC  class 
SetUpBGsC  ’SetUpBGsP; 


}; 

// 

//  The 
// 

extern 

♦endif 


t 
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